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Preface 



The advent of the microchip has resulted In the 
Invention of a product which, ten years ago, was 
completely unthinkable. This product Is the personal 
computer and there are now millions of families who own 
their own computer. This book Is about one such 
machine, the Dragon. 

The Dragon Is a second-generation personal computer. 
In contrast to early personal machines which were slow, 
had small memories and low-resolution monochrome 
displays, the Dragon offers a fairly large memory, 
high-resolution colour graphics, sound synthesis and a 
professional-quality keyboard. There are two versions 
of the Dragon available, the Dragon 32 and the Dragon 
64, and the material in this book is relevant to both 
of these machines. 

Personal computers are remarkable value for money. 
Most of them are more powerful than machines of the 
early 1960 ' s which cost hundreds of thousands of pounds 
or dollars. Furthermore, personal machines are well- 
built and reliable, much more so than early large 
computers. However, the weakest aspect of most 
personal machines is the descriptive documentation 
provided with the machine. Whilst this is no real 
hardship to those who only use their machine for game 
playing, the hobbyist who wishes to make the most of 
his machine has a tough time finding out technical 
details of his system. 

This book is intended for such readers and for those 
readers who have explored the BASIC programming 
capabilities of their machine and now want to go 
further. We do not assume any technical knowledge of 
computing apart from an ability to write and understand 
BASIC programs. Inevitably, this means we must include 
some introductory material which can be skipped by 
readers with experience in computing. 

When this book was written, the only Dragon 
available was the Dragon 32 . As a result, the material 
here was written for that machine but most of the 
examples are equally relevant to the Dragon 64 . Time 
has not permitted us to include Dragon 64 details in 
the text, but we have provided an appendix (Appendix 5) 
summarising the differences between the Dragon 32 and 
the Dragon 64 . We have also included an appendix 



(Appendix 8) which covers details of the Dragon ' s disk 
operating system. 

Many readers will be aware that the Dragon and the 
Tandy Color Computer make use of the same M6809 
processor chip and the same BASIC system developed by 
Microsoft. As a result, much of the material here is 
also relevant to the Tandy machine and users of that 
system may be able to pick up useful hints and tips 
from it. 

The book is about the internal workings of the 
Dragon rather than about programming. We describe the 
M6809 processor which is used in the Dragon and show 
how machine code programs for that processor can be 
written in assembly language. We also describe the 
graphics system and the input/output system on the 
Dragon and, finally, we provide bits and pieces of 
technical information which may be valuable to the 
assembly code programmer. 

It is impossible for us to be comprehensive in our 
discussions of assembly code programming, graphics, or 
whatever. Rather, we provide Dragon-specific details 
rather than an extensive discussion of general 
techniques. We hope to encourage the reader to delve 
further into these application areas and we provide a 
reading list which will help you get more information 
about specific techniques. 

Printing programs in a book like this can sometimes 
be very untidy. Accordingly, we have taken some 
liberties with program commenting and have used lower 
case letters for commenting in all of our programs. We 
may also have made some other minor changes to the 
program layouts so that they are easier to read but the 
actual program code has not been changed. 

There are many people who have contributed in one 
way or another to the ideas and techniques presented in 
this book anongst them our colleagues at the Department 
of Computer Science, University of Strathclyde. We 
would also like to express our gratitude to those at 
Dragon Data Ltd., in particular to Tony Clarke, Richard 
Wadman and Derek Williams. Permission to use the 
Dragon logo in our examples was kindly granted by 
Dragon Data Ltd. 

Finally, special thanks must go to our families 
especially our wives Pauline Smeed and Anne Sommerville 
for their support, encouragement and tolerance of lost 
evenings and weekends throughout the writing of this 
book. 

Ian Sommerville 
Duncan Smeed 
August 1983 



Chapter 1 

Introducing the Dragon 



Every computer, be it mainframe, minicomputer or 
microcomputer, is made up of a very large number of 
electronic components which can be viewed at greater or 
lesser levels of detail . At the highest level, the 
computer can be considered as an organised collection 
of devices namely: 

(1) A processor. 

This is the device which actually carries out the 
computations (add, multiply, compare etc.) on 
elements of data. 

(2) A store. 

This is the device which is used to store infor- 
mation so that it may be readily accessed by the 
processor. This information can be transferred 
to and from other system devices. 

(3) One or more peripheral controllers. 

Every computer needs some way of getting informa- 
tion from and passing information to the outside 
world. This is accomplished through peripheral 
devices such as floppy disks, printers, key- 
boards, video displays, etc. Each of these dev- 
ices needs a controller built into the computer 
system to ensure that information is properly 
transferred to and from the processor and memory. 

(4) A clock. 

This is not a clock to tell the time but is real- 
ly a pulse generator which ensures that the 
operation of all the other devices making up the 
system is synchronised. 

There are various different ways of connecting these 
devices together so that they operate as a computer. 
One of the most common interconnection techniques, 
particularly in minicomputer and microcomputer systems, 
is to connect all the system devices to a common data 
highway. This connection is sometimes called a bus. A 
diagram of such an interconnection is shown in Figure 
1.1 where PI, P2 , and P3 are peripheral controllers . 




Fig. 1.1 Microcomputer organisation 



Notice that the clock has a separate connection to 
the other system components and that some of the 
peripheral devices are 'one-way' devices. For example, 
a printer Is a write-only device - you can only 
transfer Information to It, and a keyboard Is a read- 
only device - you can only transfer Information from 
It. 

On microcomputer systems (like the Dragon) , the 
processor Is built onto a single microchip as are each 
of the peripheral controllers. The memory Is normally 
built as a number of connected microchips. 

These chips are bonded Into holders which have a 
number of pins sticking out of each edge. Some of 
these pins are connections to the data highway and 
others are connections to control lines (like the clock 
connection) . The number of pins on a chip depends on 
the type of Information which must be transferred and 
the number of control signals Input and output. 
Normally, more complex chips, like microprocessor 
chips, have more pins than (relatively) simple 
peripheral controller chips. 

The next level down from the computer organisation 
Is sometimes called the computer architecture. In the 
same way as a building has an architecture which Is an 
overall structure tailored to the building's users, so 
too does a computer. In the case of a computer, 
however, the architecture Is the structure as seen by 
computer programs running on the machine. Just as 
building architecture Is seen as an organisation of 
rooms, corridors, walls, etc. rather than an 
organisation of elementary components such as bricks, 
floorboards and pipes, computer architecture Is not 
concerned with basic electronic logic components. 
Rather, It Is the collection of these components Into 
larger functional units . 

The computer architect Is mostly concerned with the 
design of the processor and how It can be set up to 
transfer Information to and from other system 
components. The most Important of these Is the store. 



Therefore, a major part of the architect 's job is to 
design the processor so that it makes optimum use of 
the system' s memory. 

In this chapter, we introduce basic ideas of how 
information is represented in a computer and we 
describe, in general terms, the principles of computer 
architecture. We then go on to describe the Dragon's 
hardware organisation and the chapter concludes with a 
description of how the Dragon's memory is used. 

1.1 INFORMATION REPRESENTATION 

At their most fundamental level, all the components of 
a computer are fabricated out of electronic switches 
which can only be in one of two states - they can be on 
or off. This means that the ideal way to represent 
information in a computer is as a binary pattern, a 
pattern of Is and Os. These patterns can represent 
numbers, characters, states of a device, colours, etc. 
As long as the interpretation of a pattern is known in 
advance, any information can be encoded in binary form. 
The most common use of binary patterns in a computer 
is to represent numbers. Binary numbers are numbers 
whose base is 2 and digits in a binary number represent 
powers of 2. For example, the binary number 

10010111 

can be converted to our more familiar decimal notation 
by considering it to be: 

1 (2 7 ) +0 (2 6 ) +0 (2 5 ) +1 (2 4 ) +0 (2 3 ) +1 (2 2 ) +1 (2 1 ) +1 (2°) 

If we carry out these multiplications and additions, we 
find that the above binary number represents the 
decimal number 151 . Starting from the right, each 
place in a binary number represents an increasing power 
of 2. This is a familiar idea which is the basis of 
all modern number systems. Decimal numbers, numbers 
whose base is 10, are organised so that each place 
represents a power of 10. Therefore, the number 3506 
can be considered as: 

3(10 3 ) + 5(10 2 ) + OflO 1 ) + 6(10°) 

The number of distinct numerals needed to represent any 
number depends on the base of that number system. In 
general, if the number system base is m, m-1 distinct 
numerals plus zero are needed. Therefore, for the 
decimal system we need the numerals 1, 2, 3, 4, 5, 6, 
7, 8, 9, 0. For a hexadecimal system, whose base is 
16, these must be extended with extra symbols 
representing 10, 11, 12, 13, 14, 15 and the numeral set 
is 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, 0. The 



binary system has a base of 2 so only a single digit, 
1, plus is needed in the representation of any binary 
number. 

Normal arithmetic operations such as subtraction, 
addition, multiplication, and division can be carried 
out on binary numbers in exactly the same way as on 
decimal numbers . The following sums show examples of 
binary arithmetic. 

11001101 10011001 

+01101101 -00010111 

100111010 10000010 

The rules to remember are that 1 + 1 is carry 1 and 
that - 1 is 1 borrow 1 . 

The other computations (0 + = 0, 1 + = 1, 1 - 1 = 
0, 1-0 = 1) are as you would expect and have no 
associated carry or borrow. 

Binary arithmetic is tedious and error prone for 
humans but, fortunately, is very straightforward for 
computers. It is relatively easy to build logic 

circuits which add binary numbers and, as we shall see 
later in this section, these are all that are required 
to implement all the arithmetic operations of add, 
subtract, multiply, and divide. 

Normally, when we write down numbers their length is 
unbounded. That is, each number can have as many 
digits as we like. The designer of a computer memory, 
however, doesn't have this flexibility. Computer memory 
is made up of many distinct cells each of which can 
store a fixed number of binary digits or bits. 
Normally, each cell stores 8 bits (a byte) and the 
number of bits used to represent a number must be a 
multiple of 8. Combinations of 2 or more bytes used to 
store numbers are usually called a machine word. 

The bytes in the computer's memory each have a 
unique address which distinguishes that byte from all 
others . Addresses are simply numbers which start at 
zero and increase by 1 for each byte. On a 

microcomputer like the Dragon there are 32768 bytes in 
user memory so addresses range from to 32767. For 
convenience, memory bytes are divided into blocks of 
1024 (called IK) so we say that the Dragon has 32K or 
64K bytes of store. 

An analogy can be drawn between a computer's memory 
and the lockers in a sports stadium. Each locker has a 
number (its address) which distinguishes it from all 
other lockers and items can be stored in the locker. 
The locker number doesn 't affect what 's stored in it 
nor does the memory address in a computer . The byte 
with address number 23456 can have any number in it. 
Just as the lockers in a stadium can have names 
associated with them as well as numbers (John Brown ' s 



locker, Mary Jones's locker etc.) so too can memory 
bytes. Names are often more convenient than numbers 
when referring to memory bytes and we shall see in a 
later chapter how this facility can be used. 

On most microcomputers, the number of bits used to 
represent an integer (a number without a fraction) is 
16, with 32 bits used to represent real 
numbers (numbers with fractions) . This means that 
integers occupy 2 memory bytes and real numbers occupy 
4 memory bytes. This size limitation restricts the 
magnitude of numbers which can be directly stored and 
manipulated by the computer and it is very important 
that the computer user bears this in mind when using 
his machine for numeric computations. 

However, the restriction on the number of digits in 
a number has a hidden advantage. It allows us to 
represent negative numbers in such a way that the 
operation of subtraction can be carried out by adding 
the numbers concerned. This representation of negative 
numbers is called two's complement representation. 

Complement arithmetic, which depends on numbers 
having a fixed, maximum number of digits, works with 
numbers of any base. The numbers involved, however, 
must have a special binary tag, called a sign bit, 
which indicates whether the number is positive or 
negative. Negative numbers have a sign bit of 1, 
positive numbers a sign bit of 0. 

We illustrate the principles of complement 
arithmetic using decimal numbers rather than clumsy 
binary numbers but we assume that the maximum length of 
a number is 3 digits. That is, we place the 
restriction on our number system that only numbers from 
to 999 may be represented. Say we want to carry out 
the subtractions 327 - 104 and 96 - 297. These are, of 
course, equivalent to the additions 327 + (-104) and 96 
+ (-297) . The results of these additions are, in the 
first case, 223 and in the second -201 . 

Positive numbers in complement notation are 
represented by the number itself with an associated 
sign bit of 0. Therefore, 327 is 0327 and 96 is 0096. 
The value of negative numbers in complement notation is 
formed according to the following formula: 

(maximum possible number) +1- (absolute number value) 

Therefore, where 999 is the maximum possible number, 
-104 and -297 have the following complement 
representations : 

(999 + 1-104) = 1896 
(999 + 1 - 297) = 1703 

Notice that we have added a sign bit (=1) to the left 
of the number to indicate that it is a negative number. 



The subtractions above can now be carried out by adding 
the numbers in complement form. In the first case, 
0327 + 1896 = 2223. However, because the sign bit is 
always binary, 2 is actually '10' so we get an answer 
of '10 '223. Because the length of the number is 
restricted, we throw away the 1 in the leftmost 
position to get the correct answer 0223. 

Similarly, 96 - 297 is 0096 + 1703 = 1799. This is 
a negative number (sign bit = 1 ) , so we must convert it 
back to our more conventional representation using the 
same formula as was used to convert to complement form. 
The conversion therefore is: 

-(999 + 1 -799) = -201 

This whole business might seem to be a bit of a fiddle 
with digits being discarded in an apparently arbitrary 
fashion and with binary and decimal numbers being mixed 
up in the sign bit and the number itself. However, it 
can be mathematically proven that complement arithmetic 
always works. The proof isn't relevant here - what is 
relevant is that two ' s complement works very well on 
computers and that it is very easy to form the two's 
complement of any binary number. 

To form the two's complement of a binary number, all 
the 1 bits are changed to and all the bits to 1. 
This operation is called complementing . One is then 
added to the number to get the two's complement 
representation. For example, the binary numbers 

01101100 and 00101101 have two's complements 10010100 
and 11010011 respectively. The leftmost bit is the 
sign bit and operations on it fit in naturally with 
other binary arithmetic . 

Notice, however, that the need for a sign bit 
reduces the maximum and minimum numbers that can be 
represented on a computer. On a machine which uses 16 
bits to represent integers, the leftmost bit must be 
the sign bit so only 15 bits are used for the number 
representation. This means that the largest positive 
integer on such a machine is 32767 and the largest 
negative integer is -32768. It is left as an exercise 
for the reader to work out why there is one extra 
negative number. 

Normally, microprocessors are only equipped with 
hardware units which allow them to add numbers 
together. Subtraction is implemented as described 

above and multiplication and division are implemented 
in software as sequences of repeated additions for 
multiplications and subtractions for division. 

So far, we have concentrated on the representation 
of numbers in a computer but character processing is at 
least as important as numeric computation for most 
microcomputer users. As we said at the beginning of 
this section, anything can be represented as a binary 



pattern as long as we know how to interpret it so 
characters are normally held in a memory byte as an 8- 
bit binary pattern. 

There exist a number of different conventions 
governing which patterns represent which characters but 
the most commonly used representation on microcomputers 
is the ASCII (standing for American Standard Characters 
for Information Interchange) representation. Under 
this system, 7 bits are used for character 
representation and the 8th (leftmost) bit is always 
zero. As well as codes for the upper and lower case 
letters, 'A'-'Z', 'a'-'z', the digits, '0'-'9', and 
punctuation characters the ASCII system also defines 
special unprintable characters meaning 'end of 
transmission', 'ring a bell', 'please acknowledge', 
etc. A table of characters and their associated ASCII 
values is provided in Appendix 6. 

1.1.1 Hexadecimal notation 

The sequences of Is and Os which make up binary numbers 
are very awkward for people to use. Because the 
numbers are so long, it is very easy to miss out a 
digit or to interchange a 1 and a 0. Naturally, this 
changes the value of the number and this can completely 
change the meaning of a computation. 

Ideally, it is best to work in terms of decimal 
numbers and names because these are the types of symbol 
that we learn to manipulate at an early age. However, 
it is, unfortunately, sometimes necessary to talk in 
the computer's terms, that is, in binary. A shorthand 
notation for binary numbers allowing us to write down 
binary equivalents in as few digits as possible reduces 
the number of errors which we make. Hexadecimal 
notation is one possible shorthand for binary numbers. 

Hexadecimal numbers are numbers whose base is 16. 
This means that the rightmost hexadecimal (hex for 
short) digit represents 0-15, the next digit represents 
the number of 16s to the power 1, the next the number 
of 16s to the power 2 and so on. As discussed earlier, 
we need 15 digits plus zero for a number system whose 
base is 16. The hexadecimal digits are: 

012345679ABCDEF 

The number 10 is represented by A, 11 by B, 12 by C, 13 
by D, 14 by E and 15 by F. Some examples of 
hexadecimal numbers and their associated decimal values 
are: 

9 9 

IF 31 (16 + 15) 

23 35 (2(16) + 3) 

CI 199 (12(16) + 7) 

FF 255 (15(16) + 15) 

5BE 1470 (5(256) +11(16) +14) 
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It is very easy to convert from binary numbers to 
hexadecimal numbers and vice versa. Hexadecimal 

numbers represent values from to 15 and this is 
exactly 2 to 2 - 1. We need 4 binary digits to make 
a hexadecimal digit so converting from binary to 
hexadecimal involves chopping the binary number into 
groups of 4 bits and then writing down the associated 
hexadecimal digit. For example: 

10110111010110111 16EB7 
1110011011011100 E6DC 

Conversion from hexadecimal to binary is equally easy 
as long as you memorise the binary patterns for the 
digits from to F . These are: 






0000 


8 


1000 


1 


0001 


9 


1001 


2 


0010 


10 


1010 


3 


0011 


11 


1011 


4 


0100 


12 


1100 


5 


0101 


13 


1101 


6 


0110 


14 


1110 


7 


0111 


15 


1111 



These patterns can be calculated very easily but after 
using binary and hexadecimal numbers for a while, you 
will find that you have, in fact, memorised them. Some 
examples of hexadecimal binary translations are: 

A1C4 1010000111000100 

4FFF 010011111111 

5670 0101011001110000 

As you read through the book, you will see lots more 
examples of hexadecimal numbers as we always use them 
in preference to binary when discussing particular 
representations . In particular, we always use 

hexadecimal numbers to refer to memory addresses so 
when you see an address of 433, say, this is 
hexadecimal 433 which is decimal 1075. 

1.1.2 Decimal arithmetic 

One of the problems which arise when binary arithmetic 
is used in a computer, where 16-bit words are used to 
store integer numbers, is that the maximum integer 
which can be represented is 32767 and the minimum 
integer is -32768. One way round this is to use so- 
called 'decimal notation ' where numbers are represented 
as a sequence of digits rather than in absolute binary 
form. 

From the table above, it is clear that the 
representation of the digits 0-9 requires that 4 bits 
be set aside for each digit. Therefore, each memory 
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cell can hold 2 digits. The table below shows examples 
of numbers represented in both decimal and binary form. 

Number Binary representation Decimal representation 
2 " 00000010 00000010 

55 00110111 01010101 

438 000110110110 010000111000 

2583 101000010111 0010010110000011 

There is a marked difference between the decimal and 
the binary representation of a number so special 
routines are required to perform decimal arithmetic . 
Although decimal numbers take up more space than their 
binary equivalents, they have the advantage that it is 
easier to write special routines to perform arithmetic 
on large decimal numbers than it is to write such 
routines for binary numbers whose representation 
requires more than 16 bits. The Dragon has an in-built 
instruction, called Decimal Adjust, to help the 
programmer in writing such routines. 

Although decimal arithmetic is very important for 

commercial applications programs, the hobbyist and 

scientific computer user has no real need of it. We 

have introduced it here for completeness but we do not 

use it in this book. Rather, we assume that all 
numbers may be represented as integers in the range 
-32768 to 32767. 

1.2 PROCESSOR ARCHITECTURE 

The central device in a microcomputer system like the 
Dragon is the microprocessor chip. The processor is 
that device which carries out all data transformations . 
That is, given input information, the processor can 
manipulate this and transform it to the output required 
by the programmer. The function of a computer program, 
be it in BASIC or some other programming language, is 
to define how the processor should transform its input 
into the appropriate output . 

The processor has an internal structure, its 
architecture, which consists of lower level components 
and their interconnections . As far as the programmer 
who wants to get the most out of his machine is 
concerned, the most important of these components are 
the processor registers. 

A register is simply an electronic device which can 
be used to store information. Usually, its width (the 
number of bits it can hold) is equal to or some 
multiple of the basic memory cell size. In the 

Dragon's processor, register widths are either 8 or 16 
bits and they can therefore hold 1 or 2 memory bytes. 

There are two important distinctions between a 
register and an ordinary memory byte or word: 
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(1) The processor can access information in a regis- 
ter more quickly than it can access information 
in a memory cell . The reason for this is partly 
due to the way in which registers are constructed 
and partly due to the fact that a bus transfer 
between processor and memory is not required. 

(2) Registers may be connected, via an internal pro- 
cessor bus, to other processor components which 
can transform information held in registers or 
which can recognise particular data patterns in 
the register. These patterns can be used to 
trigger corresponding actions by other processor 
components. The most important of these com- 
ponents, which are present in every processor, 
are the arithmetic and logic unit (ALU) and the 
control unit . These are discussed later in this 
chapter . 

Registers in a processor may be classified as either 
general-purpose registers or as special-purpose 
registers. General-purpose registers may simply be 
thought of as extensions of the computer's memory. 
Normally, information which is accessed very frequently 
is held in such registers. It is up to the programmer 
to transfer frequently accessed information to 
general-purpose registers before it is accessed and to 
save it in memory when the register is needed for other 
purposes . 

Special-purpose registers may also be used to store 
frequently accessed information. However, instead of 
general information, that is, anything the programmer 
wants, being stored in such registers particular items 
of information are always held there. Other types of 
special-purpose register are accumulator registers and 
condition-code registers which are used as ALU input 
and output registers. 

The notion of an arithmetic and logic unit has 
already been introduced. This is a component whose 
function is to carry out arithmetic operations such as 
add, negate, etc. and logical operations such as 
compare, complement, etc. The particular operations 
available on the Dragon are described in a later 
chapter - you don 't need to know these details to 
understand the general purpose of an ALU. 

Accumulator registers are those registers which may 
act as ALU inputs and outputs. It is not usual to 
connect all registers to the ALU. Rather, only one or 
two accumulator registers are directly connected to 
this unit and all traffic to and from the ALU must pass 
through these accumulators. 

When some arithmetic and logical operations take 
place, particular conditions resulting from these 
operations must be 'remembered' for subsequent 
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operations. For example, if two values are compared 
for equality, it must be remembered whether they are 
equal or not . Similarly, if an addition produces a 
carry, this must be remembered. It is the function of 
the condition-code register (CCR) to hold this kind of 
information for subsequent use by the programmer. The 
exact conditions noted in this register differ from 
machine to machine - the details of the Dragon ' s CCR 
are described in the following chapter. 

Although general arithmetic operations must all take 
place through the accumulator registers in a processor, 
it is sometimes possible to perform very limited 
addition and subtraction operations in other special- 
purpose registers. These operations can take place 
automatically before or after the contents of a 
register are accessed. Typically, this auto 

increment /decrement facility allows 1 or 2 to be added 
or subtracted from the value in the register. This is 
particularly useful when using so called index 
addressing where a register contains the address of a 
memory location. Indexed addressing is fully described 
in the next chapter of this book. 

We have already introduced the idea that a computer 
program specifies how program input is transformed to 
the appropriate output. Writing a program in BASIC, 
say, is a convenient way for the user to specify this 
transformation but, at the processor level, a BASIC 
program can 't be directly executed. 

Rather, a translation process must take place where 
the BASIC program is converted to a sequence of 
primitive machine instructions. This sequence 

specifies the information transfers between the 
computer's memory and the processor and the 
operations (add, compare, etc . ) to be carried out on 
this information. 

Within the processor, the machine instructions 
always make use of the processor's registers. Some 
instructions are dedicated to data movement to and from 
memory, some to arithmetic and logical operations , and 
some to controlling the order of execution of the 
instruction sequence . 

Each instruction has a unique operation code (op- 
code) which distinguishes that instruction from all 
others. This op-code is simply a binary number which 
is used by the control unit in the processor to 
determine which operation to carry out . As binary 
numbers (or even hexadecimal numbers) are alien to 
humans, we normally refer to instructions by means of a 
mnemonic related to the function of the instruction. 
Typical instruction mnemonics are: 

ID Transfer (LoaD) information into a register 

CLR Set a register to zero (CLeaR) 

INC Add 1 (INCrement) the contents of a register. 
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As well as an op-code, each instruction may have one or 
more address fields which specify the registers and/or 
memory locations used by the instruction. These address 
fields specify where the instruction can find the data 
on which it operates (its operands) . They can be 
specified in a number of different ways (addressing 
modes) and an understanding of these addressing modes 
is vital for the programmer who wishes to write his own 
machine language programs. Because, they vary so much 
from machine to machine, addressing modes are not 
discussed further here but those of the Dragon ' s 
processor are covered in the following chapter. 

The machine instructions making up a program are 
themselves stored in the computer's memory and are 
fetched, one by one, from the memory to the processor. 
Each instruction may occupy one or more memory cells - 
in the Dragon, for example, instructions may take up 1, 
2, 3, 4 or 5 bytes. 

The processor control unit fetches instructions from 
memory, identifies each instruction and initiates those 
components which actually carry out the specified 
operations. In every processor there is a special- 
purpose register called the program counter (PC) which 
holds the memory address of the next instruction to be 
executed by the processor . 

There is no direct way for the programmer to affect 
the operation of the processor's control unit in its 
fetching and decoding of the machine instructions. 
However, the address in the PC register can be changed 
by the programmer thus allowing him to modify the order 
in which instructions are executed. This facility means 
that it is possible to repeat groups of instructions 
(loops) and to skip over one or more instructions if 
some particular condition holds (conditions) . To the 
BASIC programmer, the familiar forms of these are FOR 
statements and IF statements. 

1.2.1 Stacks 

The machine instructions for a particular program are 
normally held in a linear sequence of cells in the 
computer's memory. This sequence may be accessed in any 
order by modifying the value of PC so that the 
instruction to be executed is the next one fetched by 
the processor's control unit. 

Sometimes it is also convenient to store and access 
data in the same way. You may normally access the data 
sequentially using a register to hold the address of 
the next data item to be selected. By modifying the 
value in this register, you can change this sequential 
data access pattern and get to any item of data which 
you need. 

On other occasions, however, it is convenient to 
restrict the way in which data is accessed. 
Restrictions of this sort are not arbitrary but are a 
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safety feature which reduces the chance of the 
programmer making mistakes. There are various 

different ways in which restrictions can be applied and 
the particular technique chosen must depend on the 
application being programmed. For a full discussion of 
these data structures the reader must look at the 
specialised texts on this topic such as those suggested 
in the reading list. However, one of these data 
structures is so important that you must understand it 
if you are to understand the rest of the book. This 
structure is the stack. 

Arranging data in a stack is a technique of limiting 
data storage and access so that the last data item 
placed on the stack is the only item which may be 
removed from the stack. Once this item has been 
removed, we can then get to the item below it, remove 
it, and so on. 

This can be imagined by comparing the data on the 
stack to a pile of plates in a restaurant kitchen. 
Assume that a dishwasher is adding plates to this pile 
after cleaning them and that a waiter is removing 
plates for serving food. The plate which the waiter 
takes from the pile is always the last plate put on the 
pile by the dishwasher. Like a data stack, the pile of 
plates is a last-in, first-out (LIFO) structure. Items 
are removed in the inverse order to that in which they 
are placed on the stack. 

Stacks are easily implemented in a computer system 
by reserving an area of memory for the stack and by 
associating a special-purpose register called a stack 
pointer (SP) with this memory area. The stack pointer 
always holds the address of the last item placed on the 
stack, that is, the top of the stack. When an item is 
added to the stack, the SP register is incremented and 
the item placed at this address. When an item is 
removed from the stack, the item pointed to by SP is 
first copied to a register and SP is then decremented 
to point at the new top stack element. 

In the traditional stack model, the base of the 
stack is at a low memory address and the stack grows 
upwards so that elements placed on the stack have 
increasing memory addresses. However, this is an 
arbitrary convention and it is equally straightforward 
to implement a stack which grows downwards in memory. 
This means that push in element on the stack involves 
decrementing the stack pointer and popping an element 
from the stack involves incrementing the stack pointer. 

Stacks in the Dragon are implemented in this way so 
that the base of the stack is at a high memory address 
with stack elements in successively lower addresses. 

We shall see in later chapters how stacks can be 
extremely useful to the programmer. They are so 
important that many processors (including the one built 
into the Dragon) provide special instructions to add 
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information to and remove information from the stack. 
These instructions are: 

PUSH This instruction copies one or more 

registers onto the stack and moves 
the stack pointer 'up' by the 
number of register bytes copied. 

PULL (or POP) This instruction copies one or more 
items from the stack into registers 
and moves the stack pointer 'down ' 
by the number of bytes copied. 

The provision of instructions like these is one of the 
features of the Dragon which makes it such a powerful 
computer . 

1.3 THE ORGANISATION OF THE DRAGON 

We now move on from generalities and general principles 
of computer organisation to details of the organisation 
of the Dragon itself. Every microcomputer is inherently 
complex and the Dragon ' s hardware is made up of about 
20 microchips and their interconnections plus a power 
supply, peripheral device connectors, etc. The usual 
way of describing system hardware is by means of a 
block diagram showing the various hardware components 
and their interconnections. Figure 1.2 is such a block 
diagram of the Dragon's hardware organisation. 

As we suggested above, the hardware on a 
microcomputer system can be considered as being 
composed of three interacting subsystems. These are: 

(1) The processor 

(2) The memory 

(3) The input/output system 

The processor built into the Dragon is a single 
microchip which is designated the M6809E or, simply, 
the M6809. This is an advanced 8-bit processor which 
means that its data highways are 8-bits wide but it 
also makes provision for operations on 16-bit data 
elements. We shall not discuss any details of this 
system here as both Chapter 2 and Chapter 3 are devoted 
to the architecture of the M6809 processor . 

There is no explicit clock component shown in the 
block diagram although we explained in the previous 
section that the clock was an inherent part of every 
computer system. In fact, the box labelled 

'Synchronous address multiplexor ' is a multi-function 
chip which includes a clock and which acts as the 
interface between the processor and the random-access 
memory. 
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The M6809 processor is designed to operate with data 
addresses of 16 bits so the maximum memory size which 
can be built into the Dragon is made up of 2 16 or 65536 
bytes. The term IK is used to mean 1024 bytes so the 
maximum memory size on the Dragon is 64K bytes. The 
Dragon 32 actually has 48K of inbuilt memory with the 
capability to expand this to 64K using the cartridge 
slot. The Dragon 64 has 80K of in-built memory but 
only 64K may be in use at any one time. 

In the block diagram of the hardware, the units 
marked '32K Dynamic RAM' and '8K ROM' make up the 
memory of the Dragon. The two ROM (read-only memory) 
units hold the BASIC system and, because this memory is 
read-only, it is impossible to change any information 
stored in these units. However, you can read 
information stored there and we shall describe later 
how to make use of some of the BASIC system facilities 
by calling them directly from assembly code. 

The dynamic RAM on the Dragon 32 is the user ' s 
memory area which is used for the storage of BASIC and 
machine code programs, user data, etc. As the name 
implies, the Dragon 32 has 32K bytes available for this 
purpose whereas the Dragon 64 has twice as much 
available to the user. For many applications, 32K 
bytes is a perfectly adequate amount of memory but when 
complex disk operating systems are used, you really 
need 64K to get the most out of your machine. The way 
in which the use of memory is organised is very 
important and we describe the logical memory 
organisation of the Dragon 32 in a separate section 
below. 

The Dragon 's input /output system controllers are the 
units labelled PIAO, PIA1, and VDG. These have 
associated peripheral interfaces to the keyboard, 
display, cassette, etc. The complexity of the I/O 
system is such that we cannot describe it adequately 
here so we have devoted a complete chapter to the I/O 
system (Chapter 8) later in the book. 

1.3.1 Memory organisation 

In a system like the Dragon, the memory is not simply 
considered as a single homogenous chunk to be used in 
some arbitrary way by the user or the BASIC system. 
Rather, decisions have to be made about which areas of 
memory are to be dedicated to which function and these 
decisions have to be clearly communicated to the 
system ' s programmers so that they know how to organise 
their own programs and data. 

The usual way to communicate this information is by 
means of a memory map which is simply a schematic 
diagram of how the system's memory is used. Like any 
map, this can be presented at greater or lesser levels 
of detail and the overall memory map of the Dragon 32 
is shown as Figure 1.3. 
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The 64K bytes of memory which is potentially available 
on the Dragon 32 can be looked at as being partitioned 
into eight distinct areas. 

(1) System variables 

This is the area of IK bytes in RAM from address 
0000 to address 3FF. It holds various data values 
and I/O buffers used by the BASIC system. As 
these are in RAM, you may modify variables in 
this area but this must be done with care as in- 
cautious modification can cause the BASIC system 
to fail and require that the machine be reset. 

(2) Text screen 

This is the 512 byte area from address 400 to ad- 
dress 5FF whose contents are reflected on the 
user's display when graphics are not being used. 
The use of this area is described in Chapter 7. 

(3) Graphics screens 

The area of memory from address 600 to address 
3600 is used by the BASIC graphics system to im- 
plement its graphics commands. Again, we 
describe the use of this area in Chapter 7. If 
graphics are not used or, if only limited graph- 
ics are used, all or part of this area may be 
used for the storage of the user's BASIC program 
and its variables. 

(4) Program and variable store 

The area of memory from address 3600 to address 
7F36 is used for the storage of the user's BASIC 
program and its variables. 

(5) BASIC string store 

When character strings are used in a BASIC pro- 
gram, the string characters are held in a 
separate storage area. This area extends from 
address 7F36 to the top address in the dynamic 
RAM, 7FFF. 

(6) The BASIC interpreter 

The 16K of memory required by the BASIC inter- 
preter is provided as ROM on the Dragon 32 and is 
addressed from 8000 to BFFF. 

(7) Cartridge memory 

Memory addresses from COOO to FEFF are allocated 
to the cartridge slot on the Dragon 32 . When you 
plug in a cartridge, this contains its own read- 
only memory and this is addressed via these ad- 
dresses . 
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(8) Input/output area 

The Dragon ' s I/O system is a 'memory-mapped ' sys- 
tem where reference to specific memory locations 
cause I/O operations to take place. Therefore, 
it is necessary to dedicate some memory locations 
to input/output and, in the Dragon 32, this I/O 
area is a 256 byte area at the very top of memory 
from address FFOO to address FFFF. Broadly, this 
area is partitioned into three separate parts. 
Addresses FFOO to FF5F are reserved for the use 
of peripheral controllers, addresses FFCO to FFDF 
are used to control the synchronous address mul- 
tiplexor and addresses FFF2 to FFFF are reserved 
for interrupt vectors. The other addresses in I/O 
area are unused and reserved for future system 
expansion. More details of the function of these 
i/o-dedicated addresses are provided in Chapter 
8. 



Chapter 2 

The architecture of the M6809 



The microprocessor used in the Dragon has been given 
the code number M6809 by its designers at Motorola 
Semiconductors. The M6809 processor developed from an 
earlier Motorola microprocessor, the M6800, and it 
shares some of the features of this earlier system. In 
fact, one of the design criteria for the M6809 was that 
it should be possible to run programs written for the 
M6800 on the M6809 processor. 

The M6809 is called an 8-bit processor, indicating 
that its data highways are 8 bits wide. This means 
that a simultaneous transfer of 8 bits of information 
can be made from the processor to and from memory and 
peripheral controllers. However, the M6809 also 
includes a number of instructions which operate on 16 
bits rather than 8 bits of data and this considerably 
increases the power of the processor. 

Such 16-bit instructions provide extra power because 
8-bit data manipulation is inadequate in many cases. 
For example, consider integer arithmetic. If only 8-bit 
representation is allowed this limits the range of 
integers to 0-255. This is clearly unacceptable in 
most cases so 16-bit arithmetic operations have to be 
simulated on an 8-bit machine by using combinations of 
8-bit instructions. Naturally, this slows down the 
execution of programs. 

The provision of many 16-bit operations of the M6809 
means that programs can be written using fewer 
instructions. Therefore, these programs execute more 
quickly. Because of these extra instructions and 
because of the variety of ways in which memory can be 
accessed, the M6809 is sometimes called a second- 
generation microprocessor or, more extravagantly, the 
'programmer's dream machine ' . 

In this chapter and in the following chapter we 
describe those aspects of the M6809 machine 
architecture which are of importance to the programmer 
who wishes to write machine language programs for his 
Dragon . This chapter covers the register organisation 
of the M6809, the multitude of ways in which machine 
memory may be addressed (addressing modes) , and 
introduces some of the machine instructions available 
to the M6809 programmer. A description of all the M6809 
machine instructions is provided in Chapter 3. 
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2.1 



THE M6809 REGISTER SET 



In the previous chapter we introduced the idea of a 
register as a fast storage element built into the 
processor. The M6809 has nine such registers, all of 
which may be considered as special-purpose registers 
rather than general-purpose registers. Figure 2.1 is 
the so-called 'programming model ' of the M6809. It 
shows, diagrammatically , the M6809's registers and 
their comparative sizes . 
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Fig. 2. 1 The programming model of the M6809 



The names of the M6809 registers, their width in 
bits, and a very brief description of their functions 
are listed below: 

(1) A register (8 bits) - accumulator register 

(2) B register (8 bits) - accumulator register 

(3) X register (16 bits) - index register 

(4) Y register (16 bits) - index register 

(5) U register (16 bits) - stack pointer register 
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(6) S register (16 bits) - stack pointer register 

(7) DP register (8 bits) - direct page register 

(8) PC register (16 bits) - program counter register 

(9) CC register (8 bits) - condition code register 

The bits In an M6809 register are numbered from right 
to left starting at 0. This means that bit Is the 
rightmost bit and, for 16-blt registers, bit 15 Is the 
leftmost bit . Different machines have different 
conventions In this respect . Some processors number 
bits from left to right others, like the M6809, from 
right to left. 

2.1.1 The A and B registers 

The A and B registers are accumulator registers which 
are used to hold the operands and results of arithmetic 
operations. There are a variety of machine 

Instructions which make use of these registers and 
examples of these are given below. 

The Instruction examples In this chapter are set out 
according to the following general format: 

<machlne code> (mnemonic) <operand> (comment) 

We use diamond brackets <> to mean 'an Instance of so 
(mnemonic) means any Instruction mnemonic may replace 
the character string (mnemonic) . We also use the 
notation MEM( (address) ) when referring to particular 
addresses In memory so MEM(A0E4) means the memory 
location whose address, In hexadecimal, Is A0E4 and 
MEM (FRED) means the memory location whose symbolic 
address Is FRED. All memory addresses are given In 
hexadecimal or are symbolic addresses unless explicitly 
stated otherwise. 

The machine code, In hexadecimal, Is provided for 
each Instruction example In this chapter. This Is the 
actual code loaded Into the M6809 memory whereas the 
Instruction mnemonic and operand Is a form of the 
Instruction which Is more understandable to the 
programmer. Most examples also have a brief 

descriptive comment explaining the function of that 
Instruction . 

Examples of Instructions which use the A and B 
registers are: 

860A IDA #10 ; A = 10 

1E89 EXG A,B ; Tmp = A: A = B: B = Tmp 

F7F1C5 STB $F1C5 ; MEM(F1C5) = B 
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5F CLRB ; B = 

8B02 ADDA #2 ; A « A + 2 

F0F1C5 SUBB $F1C5 ; B = B - MEM(F1C5) 

The A and B registers are both 8-bit registers which 
means that only a limited range of values, from to 
255, may be stored in them. For many arithmetic 
operations we need to operate on larger or smaller 
values than can be represented in 8 bits so the 
designers of the M6809 have provided instructions which 
allow the register pair A:B to be considered as a 
single register. When the registers are catenated in 
this way, they are called the D register. 

Effectively, the A register makes up the leftmost 8 
bits of the D register (bits 8-15) . This is sometimes 
called the hi-byte. The B register forms the rightmost 
8 bits of D (bits 0-7) . This is called the lo-byte. 

Many of the machine instructions which operate on 
the A and B registers have counterparts which operate 
on the D register. However, rather than 8-bit 
operations which take place automatically when A and B 
are used, the use of the D register or, indeed, any 
16-bit register automatically results in 16-bit 
operations taking place. The address in the instruction 
refers to the leftmost (most significant) byte when 
16-bit operations are specified. For example: 

CC1000 LDD #4096 ; D = 4096 

F31E62 ADDD $1E62 ; D = D + MEM(1E62) 

FD0056 STD $56 ; MEM (56) = D 

* MEM (56) = hi-byte of D 

* MEM (57) = lo-byte of D 

We shall look at more instructions which operate on the 
A, B, and D registers when we describe the M6809 
instruction set in detail in Chapter 3. 

2.1.2 The X and Y index registers 

The X and Y registers in the M6809 may be used as 
general-purpose registers to store data but, more 
commonly, they act as special-purpose registers called 
index registers. 

The information which is normally held in an index 
register is the address in memory of some other data 
item which may represent anything at all, even another 
memory address. The M6809 has several ways of 
accessing memory which makes use of these index 
registers to determine the address in memory which is 
being used. 

Index registers are a particularly efficient way of 
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determining data addresses when data Items stored In 
consecutive locations are to be accessed and processed 
In turn. The X and Y registers In the M6809 each have 
an associated auto-Increment /decrement facility which 
means that a memory location can be accessed and, 
without additional Instructions, the Index registers 
can be updated to refer to the next Item to be 
processed. 

This means that the most Important use of the X and 
Y Index registers Is for array processing. The Index 
register Is set up to refer to the first Item of the 
array and the auto Increment/decrement facility used to 
select succeeding Items In turn. 

The Index registers may also be used as stack 
pointer registers If the user needs more than two 
stacks. The U and S registers are provided as stack 
pointer registers but the auto Increment/decrement 
facilities of the X and Y registers means that they can 
also function efficiently In this role. 

Examples of Instructions which use these Index 
registers are: 



A684 


IDA 


,x 




; A = MEM(X) 


A680 


IDA 


,x+ 




; A - MEM(X) : X = X + 1 


A682 


IDA 


,-x 




; X = X - 1: A = MEM(X) 


ECA012C 


IDD 


300, 


Y 


; D = MEM(300 + Y) 


E7A6 


STB 


A,Y 




; MEM(A + Y) = B 



There are a number of other variants of Index 
addressing available on the M6809. These will be 
discussed later In section 2.2.6. 



2.1.3 The U and S stack pointer registers 
The U and S registers are 16-blt registers which may 
act as Index registers In exactly the same way as the X 
and Y registers described above. However, In many 
applications, these registers are best used as 
special-purpose stack pointer registers. Push and pull 
Instructions are available to the programmer which 
assume that these registers are being used for this 
purpose . 

In practical use, the S register Is almost always 
used as a stack pointer register referring to the so- 
called S-stack or hardware stack. The hardware stack 
Is used when calling subroutines and when swapping 
control from program to program. The state of the 
program which Is Interrupted Is saved on this stack and 
restored when that program Is restarted. This use of 
the hardware stack Is described later In the book when 
Interrupt-drlven programming Is described. 
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The U register may be used as a stack pointer to the 
so-called U-stack or user stack. However, the 

programmer may not need this facility In which case the 
U register may be used as an Index register In exactly 
the same way as the X and Y registers. 

The M6809 stack convention Is that stacks grow 
downwards In memory. That Is, when an element Is pushed 
onto the stack, the stack pointer Is decremented before 
the push operation so that that element has a lower 
memory address than the previous top stack element. The 
stack pointer registers S and U always point at the top 
byte on the stack. In this respect, the M6809 Is 
different from some other stack-based systems where the 
stack pointer refers to the next available location on 
the stack. 

Some examples of how the U and S registers may be 
used are: 

; U = U - 1: MEM(U) = A 

; S=S-1: MEM(S)=Y: S = S-2 
MEM(S)=X: S=S-2: MEM(S)=B 
S=S-1: MEM(S)=A 

: A=MEM(S) : S=S+1 : B=MEM(S) 
S=S+2: X=MEM(S) : S=S+2 
Y=MEM(S) : S=S+1 

; B=MEM(U) : U=U+1 

The push and pull Instructions for stack manipulation 
are described In more detail In Chapter 3. 

2.1.4 The DP register 

The M6809's DP (Direct Page) register Is an 8-blt 
register which always contains the address of the start 
of a 256 byte chunk (page) of memory. This register Is 
used exclusively In the so-called direct addressing 
mode. In this mode, the contents of the register are 
added to an 8-blt value specified by the user as part 
of the machine Instruction to form the effective memory 
address. For example: 

96E9 IDA $E9 ; A = MEM (DP + E9) 

DUO STB $10 ; MEM(DP+10) = B 



2.1.5 The PC register 

The PC register Is the M6809 ' s program counter . It a 
16-blt register which always contains the address In 
memory of the next machine Instruction to be executed 
by the M6809. 
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2.1.6 The CC register 

The CC register is an 8-bit condition code register 
where individual bits mark the occurrence of particular 
conditions. The bits in the register have the 
following functions: 

Bit carry bit, set in arithmetic operations 

Bit 1 two 's complement overflow bit 

Bit 2 zero bit, set when result of an operation or 

data transfer is zero 
Bit 3 negative flag, set when result of an 

operation or data transfer is less than zero 
Bit 4 normal interrupt mask, used by M6809 

interrupts 
Bit 5 half-carry flag, used to indicate a carry 

from bit 3 to 4 
Bit 6 fast interrupt mask, used by M6809 interrupts 
Bit 7 entire state saved flag, used by M6809 

interrupts 

The above descriptions of the flags in the CC register 
are very sketchy indeed but it is not appropriate to go 
into more detail here of what each flag means. Rather, 
we describe the role of individual condition code flags 
along with those machine instructions which set and 
test these flags. 

2.2 ADDRESSING MODES ON THE M6809 

One of the features of the M6809 architecture which 
distinguishes that microprocessor from earlier 
microprocessors is the variety of ways in which the 
address of a data item may be computed. In all, there 
are 19 distinct ways of representing an 
address (addressing modes) and the flexibility and 
power of these modes means that some applications may 
be coded very efficiently indeed on the M6809. 

The use of the various addressing modes is 
illustrated in Chapters 4 and 5. In this section we 
confine ourselves to a description of those modes and 
present examples of instructions which use these 
various modes. 

Before going on to look at addressing modes in 
detail, however, we must look at the structure of a 
machine instruction and examine how operand addresses 
are represented within instructions. Instructions in 
the M6809 may be 1, 2, 3, 4, or 5 bytes long depending 
on the particular instruction and on the addressing 
mode which is being used. Each instruction has two 
fields: 

(1) The op-code (1 or 2 bytes) 

(2) The operand address specifier (0, 1, 2 or 3 
bytes) 
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Notice that, In some cases, the operand address 
specifier may be empty, that Is, It doesn 't explicitly 
exist . For example, the Instruction CLRA clears the A 
register - the Inherent operand address In this case Is 
the A register and may never be anything else. 

Most Instructions, however, do have an address field 
which has the following general structure: 

(1) Postbyte (0 or 1 byte) 

(2) Value field (0, 1 or 2 bytes) 

The address field, called the 'postbyte ' , Is not needed 
by all the M6809 addressing modes and It will be 
described along with those addressing modes which make 
use of It. Simpler addressing modes only need the 
'value ' field to construct an operand address and some 
modes only require the postbyte field. 

2.2.1 Immediate addressing 

The simplest addressing mode on the M6809 Is the 
Immediate addressing mode where the Instruction operand 
Is a constant whose value Is 'built In ' to the machine 
Instruction. When programming, Immediate addressing Is 
specified by preceding the constant to be Included In 
the Instruction with the symbol #. Some examples of 
Immediate addressing are: 

C680 LDB #128 / B = 128 (decimal) 

CC0400 LDD #1024 / D = 1024 (decimal) 

108EFF00 LDY #$FFOO / Y = FFOO (hex) 

Notice that a hexadecimal value Is specified by 
preceding the Immediate value with a $ sign. The # 
symbol must also be Included to specify Immediate 
addressing as a $ on Its own has a completely different 
meaning. 

Although the Instruction operand In Immediate 
addressing mode must be an absolute hexadecimal 
constant, this can be generated by the assembler. Most 
assemblers allow the association of symbolic names with 
constants and also allow symbolic labels representing 
addresses. These may be used as Immediate operands. 

2.2.2 Extended addressing 

In the extended addressing mode, the contents of the 2 
bytes following the Instruction op-code are taken as 
the absolute address In memory of the Instruction 
operand. Extended addressing Is specified by preceding 
a numeric address (usually In hex) with the symbol $ 
or, alternatively, by writing the symbolic address of 
the operand being accessed. 

A symbolic address Is simply a name given to a 
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particular address location. This idea was introduced 
in section 1.1.2 and it is by far the most convenient 
way to refer to actual addresses in the Dragon ' s 
memory. When a symbolic address is encountered in an 
instruction, the assembler replaces it with its actual 
numeric memory address. The assembler also handles the 
conversion of mnemonics to machine code, the conversion 
of decimal and hexadecimal numbers to binary, etc. 

Examples of the M6809 extended addressing code are 
given below along with their corresponding machine code 
representations. Assume that the symbolic names CHAR1 
and PNTR have addresses AOOO and A008 respectively. 

B7A000 STA CHAR1 ; MEM(CHARl) = A 

BEA008 LDX PNTR ; X = MEM (PNTR) 

BB03A2 ADDA $03A2 ; A = A + MEM(03A2) 

2.2.3 Direct addressing 

Recall from our description of the M6809 registers that 
the processor has an 8-bit register called the Direct 
Page or DP register which always contains the address 
of the start of a 256 byte chunk (page) of memory. This 
register is used in the direct addressing mode. 

In this mode, the address of an operand is computed 
by taking the value contained in the instruction 
itself (OO-FF) and using this as the lo-byte of the 
operand address. The hi-byte is taken as the value of 
the DP register. Direct addressing is used whenever the 
address lies in the range 00 to FF since the DP 
register normally contains 00. Direct addressing can 
be forced by preceding the address with a '<' symbol in 
which case it it is essential that the DP register is 
set up with the address of the starting byte of the 
memory 'page ' being accessed. 

Registers are normally assigned values using load 
instructions but there is no load instruction which 
assigns a value to the DP register. Rather, some other 
8-bit register must be assigned a value and its 
contents then to the DP register using a TFR 
instruction. For example: 

8610 LDA #$10 ; A = 10 (hex) 

1F8B TFR A, DP ; DP = A 

Examples of the use of direct addressing are: 

DD20 STD $20 ; MEM (1020) = D 

9000 SUBA $00 ; A = A - MEM (1000) 

The use of direct addressing means that instructions 
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are short (mostly 2 bytes) and this means that programs 
are efficient in both execution speed and in the 
storage required for the program. There are also 
advantages in using this mode of addressing when 
implementing programming languages like Pascal where 
global variables may be stored in a page by themselves 
and accessed via the DP register. 

2.2.4 Register addressing 

Register addressing is an addressing mode where the 
instruction operands are always in registers with a 
postbyte used to identify the registers involved. There 
are only two instructions which make use of this 
addressing mode. These are the transfer register 
instruction (TFR) and the exchange register instruction 
(EXG) . The address field is simply a postbyte which is 
split into two parts. Bits 0-3 of the postbyte 

identify the destination register and bits 4-7 identify 
the source register . The identification value, in 
hexadecimal, for each register is: 

D register 5 PC register 

1 X register 8 A register 

2 Y register 9 B register 

3 U register A CC register 

4 S register B DP register 

Using the TFR and EXG instructions , it is only possible 
to transfer and exchange registers of like size (8 or 
16 bits) . Examples of instructions using the register 
addressing mode are: 

1F12 TFR X, Y 

1E89 EXG A,B ; Tmp = B: B = A: A = Tmp 

* where Tmp is some temporary register 

* hidden from the M6809 user 

2.2.5 Indirect addressing 

Some kinds of programming are made easier if you can 
refer indirectly to information which you want to 
manipulate. That is, you don't include the address of 
the instruction operands in the instruction but the 
address reference in the instruction is to a location 
which holds the actual operand address. 

Normally, the address part of a machine instruction 
directly refers to its operand. For example: 

LDD MAXVAL 

loads the data stored at symbolic address MAXVAL into 
register D. With indirect addressing, however, the 
address part of the machine instruction holds the 
address of the address of the instruction operand. 
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Address computation Is therefore a two-stage process. 
First, compute the address as specified in the machine 
instruction. Secondly, use this to locate the operand 
address then use this address to fetch the operand 
itself. 

This is illustrated in Figure 2.2. 
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Fig. 2.2 Indirect addressing 

It is important to remember that the use of indirect 
addressing means that the two-stage process described 
above always takes place. The effect of an instruction 
using indirect addressing is exactly the same as the 
same instruction using direct addressing inasmuch as 
the operand value, not its address, is manipulated by 
that instruction . 

Indirect addressing can be used with a number of the 
M6809 addressing modes but, of the modes which we have 
described so far, it is only possible with extended 
addressing. In this case, and in all other cases where 
indirect addressing is allowed, indirect addressing is 
specified by surrounding the address part of the 
instruction with square brackets. For example, say a 
value 00E4 is stored at address 32F0. Furthermore, 
assume the symbolic address MAXADD has a value of 10A4 
and is set up to refer to the value 00E4. The 
instruction 

CC9F10A4 LDD [MAXADD] 



specifies that the value in MAXADD is actually the 
address of the value to be loaded into the D register. 
Therefore, the effect of LDD [MAXADD] would be to copy 
00E4 into register D. The actual address reference in 
the instruction is to address 10A4 which holds the 
value 32F0 - the location where 00E4 is stored. 

This has illustrated how indirect addressing is used 
in conjunction with the extended addressing mode but it 
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may also be used with indexed addressing which is 
described below. In indexed addressing, where a 
postbyte is an inherent part of the address, bit 4 of 
the postbyte is used to indicate whether the address 
reference is direct or indirect . If bit 4 is set, the 
address is taken as in indirect reference to the 
instruction operand. 

2.2.6 Indexed addressing 

We have already described how some of the registers in 
the M6809 may be used as index registers where the 
address is computed by adding or subtracting some value 
from the value in the index register. There are a 
variety of different types of indexed addressing 
available to the M6809 programmer and these are all 
described in this section. 

The format of an address in an instruction using 
indexed addressing is: 

(1) Postbyte (1 byte) 

(2) Offset (0, 1 or 2 bytes) 

The postbyte is set up to indicate which register is 
the index register, whether that register is to be 
automatically incremented or decremented and to specify 
the form of the offset to be added to the value in the 
index register. 

The forms of indexed addressing which we shall 
describe here are: 

(1) Zero offset indexed addressing 

(2) Constant offset indexed addressing 

(3) Accumulator offset indexed addressing 

(4) Auto increment/decrement indexed addressing 

Before describing these addressing modes in detail, 
however, let us look at the structure of the postbyte 
which determines the actual addressing mode used and, 
in some cases, holds the offset which modifies the 
index register value. 

Bit 7 (the leftmost bit) of the postbyte specifies 
whether an offset is stored as part of the postbyte. 
If this bit is unset, bits 0-4 are taken as a 5-bit 
signed offset in two's complement form. This means 
that values between -16 and 15 may be held as part of 
the postbyte and automatically added to the index 
register . 

If bit 7 of the postbyte is set, this means that a 
5-bit offset is not part of the postbyte and that bits 
0-4 have a completely different meaning. In this case, 
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bits 0-3 are used to specify which type of indexed 
addressing is to be used and bit 4 is used to select 
direct or indirect indexed addressing. The 

correspondance between addressing modes and associated 
values of bits 0-3 is set out in the table below. 

Bit 4 is the indirect select bit. If it is unset, 
this indicates that the computed address is the address 
of the instruction operand. If it is set, this means 
that the computed address is to be taken as the address 
of the address of the instruction operand. 

In all types of indexed addressing, bits 5 and 6 of 
the postbyte are used to specify which index register 
is being used. Each value of this bit pair specifies a 
different index register as follows: 

X Bit 6=0, Bit 5 = 

Y Bit 6=0, Bit 5 = 1 

U Bit 6 - 1 , Bit 5 = 

S Bit 6=1, Bit 5 = 1 

When bit 7 is 1, bits 0-3 of the postbyte select the 
addressing mode to be used. The values of these 
bits (in hexadecimal) and their corresponding 

addressing modes are shown in the table below: 



Auto increment (+1) 



The index register is 
incremented by 1 after 
the address is computed. 



1 Auto increment (+2) 

2 Auto decrement (—1) 



As above, increment is 2. 

The index register is 
decremented by 1 before 
the address is computed. 



3 Auto decrement (-2) 

4 Zero offset 



As above, decrement is 2. 

The address in the index 
register is the operand 
address . 



5 ACCB offset 



The address is computed 
by adding the contents of 
register B to the index 
register contents. 



6 ACCA offset 



As above, but the 

contents of register A 
are added to the index 
register . 



7 Not used 
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8 8-bit signed offset 



9 16-bit signed offset 

A Not used 

B ACCD offset 

C PC relative, 



The value of the byte 
following the postbyte is 
added to the index 
register to compute the 
address . 

As above, but the 

following 2 bytes are 

added to the index 
register. 



The value of accumulator 
D (A:B) is added to the 
index register. 

The PC acts as an index 
register, with the 

address computed by 

adding an 8-bit offset to 
its value. 



D PC relative, 



E Not used 



As above 
offset . 



with 



16-bit 



F Extended indirect The following 2 bytes are 

the address of the ad- 
dress of the instruction 
operand. 

We have already covered extended indirect addressing 
and addressing using the program counter PC will be 
discussed in section 2.2.7. Now let us look in more 
detail at the possible indexed addressing modes. 

Auto increment/decrement indexed addressing 
This addressing mode allows 1 or 2 to be automatically 
added or subtracted from the index register value. No 
additional add or subtract instruction is necessary to 
accomplish this. When using auto increment addressing, 
the value is added to the index register after the 
effective address has been computed. In auto decrement 
mode, the value is subtracted from the index register 
and the effective address then computed. 

Examples of instructions using this addressing mode 
are: 



A7C0 STA ,U+ 
ECA1 LDD , Y++ 



; MEM(U) = A: U = U + 1 
• D=MEM(Y) : Y = Y + 2 
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AB82 ADDA ,-X ;X = X-1:A=A+ MEM(X) 

A3E3 SUBD , — S / S = S - 2 : D = D - MEM(S) 

Auto increment /decrement indexed addressing is 
particularly efficient when a number of data elements 
have to be processed in sequence. The index register 
is set up to point at the beginning or the end of the 
sequence in memory and, after each element is fetched, 
the register is incremented or decremented so that it 
points at the next element in the sequence. 

Zero offset indexed addressing 

Using this addressing mode, the value in the index 
register is taken to be the address of the instruction 
operand. Nothing is added to or subtracted from it. 
For example: 

A684 IDA ,X ; A=MEM(X) 

EDF4 STD [,S] ; MEM (MEM (D)) = D 

* Note [] meaning indirect addressing 

Constant offset indexed addressing 

In this case, a positive or negative constant is added 
to the value in the specified index register to compute 
the address of the instruction operand. The range of 
possible offsets is from -32768 to 32161 (decimal) and 
the assembler works out whether the offset is to be 
stored as part of the postbyte (-16->15) , as an 8-bit 
quantity (-128->121) or as a 16-bit quantity (-32168- 
>32161) . If the offset is not stored in the postbyte, 
it immediately follows the instruction postbyte in 
memory . 

Although a constant value is added to the index 
register value to compute the operand address, this 
modified value is not stored in the index register. 
The addition is purely temporary and the index register 
value is not changed by the use of constant offset 
addressing . Examples of instructions using this 

addressing mode are: 

EC1A LDD -6,S ; D = MEM(S-6) . 

* Note offset stored in postbyte 

* in two's complement form 

AB8816 ADDA 22, X ; A = A + MEM(X + 22) 

* Offset stored as a 1 byte value 

AB89012C ADDA 300, X ; A = A + MEM(X + 300) 

Offset stored as a 2 byte value 



* 



Accumulator offset indexed addressing 

This addressing mode is similar to constant offset 

indexed addressing but, rather than the offset being a 
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constant, the value of an accumulator register is added 
to the index register to compute the address. The 
advantage of this is that the offset can be calculated 
and loaded into the accumulator just before it is 
required. The programmer need not know the offset in 
advance as in constant offset indexed addressing. 
Examples of this addressing mode are: 

E7A6 STB A, Y MEM (A + Y) = B 

ECB8 LDD D,X D = MEM(D + X) 

2.2.7 Relative addressing 

Another mode of address computation in the M6809 is 
relative addressing where the address of an operand or 
of another instruction is computed by adding an offset 
to the program counter register. This offset may be a 
positive or negative, 8-bit or 16-bit value. We shall 
look first at how instruction operands are accessed 
using this addressing mode and then at the relative 
addressing of instructions themselves. 

Relative addressing of instruction operands makes 
use of the postbyte in the same way as does indexed 
addressing. If bits 0-3 of the postbyte are C or D 
while bit 7 is set this specifies that the addressing 
is PC relative . For example: 

AE8C08 LDX 8,PCR ; X = MEM(PCR + 8) 

DD8D0400 STD 1024, PCR ; MEM(PCR + 1024) - D 

A very important advantage of using PC relative 
addressing is that it simplifies the writing of 
position independent code. Position independent code 
is code which works in exactly the same way 
irrespective of where that code is placed in memory. 
Such code must make extensive use of relative and 
indexed addressing because extended addressing means 
that the instruction operands must always be at the 
address 'built in' to the code. 

With position dependent code, you must always load 
the program into exactly the same memory locations as 
were used previously. This is not necessarily 

convenient or even possible so it is good programming 
practice to write all programs in a position- 
independent way. 

Relative addressing of the instructions in a program 
is accomplished by means of so-called 'branch 
instructions ' . The effect of these branch instructions 
is to modify the program counter register. Thus the 
next instruction executed is not necessarily the 
instruction following the branch instruction but some 
other instruction whose address is computed by adding 
the specified offset to the value of PC. The relative 
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addressing of instructions is different from the 
relative addressing of operands inasmuch as the value 
stored in PC is modified whereas in operand addressing 
the value of PC is used but is unchanged by the address 
computation . 

The computation of relative instruction offsets is a 
tedious and error-prone task. Usually, it is left to 
the assembler to work out the appropriate value to be 
added to PC. You may mark instructions with a name (a 
label) and use this name as part of the branch 
instruction. The assembler knows the number of bytes 
occupied by each instruction so it can work out the 
appropriate offset to allow a transfer of control to 
the labelled instruction . 

This can be illustrated by a short assembly code 
sequence which is equivalent to the following BASIC 
statement : 

IF VI > MAX THEN MAX = VL 

Assume that VL and MAX are 16-bit quantities held at 
addresses AOOO and A002 respectively. The assembly 
code equivalent to the above BASIC conditional is: 



FCAOOO 


LDD VL 


; D = MEM(VL) 


10B3A002 


CMPD MAX 


; Compare D with MEM (MAX) 


2F03 


BLE NEXT 


; If VL<=MAX goto NEXT 


FDA002 


STD MAX 


; MEM(MAX) = D 


NEXT 







The branch instruction in the above sequence, BLE, 
modifies the value of PC if and only if VL is less than 
or equal to MAX. Notice that the value in the PC 
modification field is 3, the number of bytes in the STD 
instruction. It is not the number of bytes in the BLE 
instruction plus the number of bytes in the STD 
instruction. The reason for this is the PC always 
points to the next instruction in the instruction 
sequence rather than the instruction which is being 
executed . 

There are many branch instructions available to the 
M6809 programmer. They are discussed in detail in 
section 3.5 of the following chapter. 

2.3 MEMORY-MAPPED INPUT/OUTPUT 

We have seen, in Chapter 1, that a computer 
organisation includes a number of units which are set 
up as peripheral control devices to allow information 
to be transferred to and from the processor and memory 
units. Obviously, the processor must have access to 
these controllers in order to initiate data transfers 
to and from the outside world. In this section we 
describe, in very general terms how this is done. 



37 

However, as it is such an important topic we devote a 
complete chapter to details of input and output later 
in the book. 

Recall, from Figure 1.2, that the M6809 processor, 
memory and peripheral controllers all have access to a 
common data highway or bus. On M6809-based systems 
such as the Dragon, this bus is 24 bits wide. This 
means 24 bits of information can be simultaneously 
transferred from device to device. Of these 24 bits, 
16 bits are reserved for the data address and 8 bits 
are used to transfer the data itself. 

In the same way as all memory locations have a 
unique address, so too must input/output (I/O) devices 
connected to this shared bus. On some systems, the bus 
has an extra line indicating that the address on the 
bus is a peripheral rather than a memory address but 
this is not the case on M6809 systems. Rather, the 
addresses of I/O devices have exactly the same form as 
memory addresses with specific addresses reserved for 
these I/O devices. These memory addresses may not be 
used for straightforward data storage as they are 
allocated to particular I/O devices. 

This is not a severe handicap as there are usually 
only a few I/O devices on any system. On the Dragon, 
there are 256 memory bytes reserved for use by the I/O 
system. These are at the top end of memory between 
FFOO and FFFF . If we access one of these addresses 
which is allocated to an I/O device, the effect of the 
access is to initiate a data transfer to or from that 
peripheral unit . The synchronous address multiplexor 
examines addresses on the bus and detects those which 
refer to I/O controllers. The data is then routed to 
these devices for input or output. 

This type of I/O organisation where peripherals are 
associated with specific memory addresses is called, 
for obvious reasons, memory-mapped I/O. It is a 
conceptually elegant way of carrying out input and 
output as there is no need for specific instructions to 
initiate peripherals and all instructions which 
reference memory may be used to access the system's I/O 
devices. Full details of the Dragon's I/O system are 
provided in Chapter 8 and in the appendices. 



Chapter 3 

The M6809 instruction set 



In Chapter 2 we described the general features of the 
M6809 architecture and introduced, without a great deal 
of explanation, some of its machine instructions. A 
thorough knowledge of the machine instruction set is 
vital for the machine code programmer so this chapter 
is completely dedicated to a description of the M6809 
instruction set . 

At this point, we must emphasise the distinction 
between machine instructions and assembly language 
mnemonics. Machine instructions are the actual binary 
op-codes executed by the processor as it runs a 
program. Assembly language instructions are the 
mnemonics and names used by the programmer to symbolise 
these machine instructions because It is much easier 
for us to think in symbols and names rather than 
numbers . 

There is not necessarily a one-to-one correspondence 
between machine instructions and assembly language 
instructions. For example, on the M6809 there are 
over 1400 distinct machine instructions when we take 
into account all the different combinations of op-code 
and postbyte that are permitted. Fortunately, however, 
there are only 59 distinct instruction mnemonics which 
must be remembered by the assembly language programmer 
along with the register names and the symbolism 
associated with the different M6809 addressing modes. 
Combinations of these allow all possible machine 
instructions to be represented. 

The reason for the enormous discrepancy between the 
numbers of assembly language and machine code 
instructions is that many assembly language 
instructions have variants for each of the machine 
registers and for each addressing mode allowed with 
that instruction. For example, the instruction 

specifying that a register is to be loaded with an 
immediate value has the form: 

LD<register> <value> 

This is all that need be remembered by the assembly 
language programmer. However, there are seven distinct 
machine language op-codes associated with this 
instruction, one for each register that may be directly 
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loaded. The assembly code mnemonics for these are LDA, 
LDB, LDD, LDX, LDY, LDU, and LDS . These have 

associated op-codes of 86, C6, CC, 8E, 108E, CE, and 
10CE. 

All of these load instruction mnemonics have a 
different op-code associated with each permitted 
addressing mode . For example , if immediate addressing 
is used with an LDA instruction the op-code is 86. If 
direct addressing is used, the op-code is 96, for 
indexed addressing the op-code is A6 and for extended 
addressing B6. Instructions which load the other 
registers also have distinct op-codes for each 
addressing mode so, in all, the LD instruction mnemonic 
has 28 distinct machine instructions which may be 
derived from it. If we consider postbytes to be part of 
the instruction, this gives many more machine language 
derivations from an assembly language load instruction. 

It is practically impossible to program directly in 
machine language because of the enormous number of op- 
codes that must be remembered by the programmer. 
Normally, an assembler is used to carry out the 

tedious task of translating mnemonics to op-codes, 
working out relative offsets and constructing 
postbytes. At worst, if an assembler is not available, 
the programmer should write his program in assembly 
code as if an assembler is at hand and then translate 
manually to machine code. Attempting to program 

directly in machine code inevitably leads to 
frustration, boredom and many errors. 

A complete table of assembly language mnemonics and 
their associated machine op-codes is provided in 
Appendix 1 . It must be emphasised, however, that hand 
translation from assembly code to machine code is not 
recommended for anything apart from very short 
programs . 

The instructions available to the M6809 programmer 
can be considered under seven distinct headings. These 
are: 

(1) Data movement instructions 

Instructions which transfer information to and 
from registers and memory. 

(2) Arithmetic instructions 

Instructions used to implement arithmetic opera- 
tions such as add and subtract . 

(3) Logic instructions 

Instructions used to execute logic operations 
such as or and shift. 

(4) Test instructions 

Instructions which set flags in the condition 
code register depending on operand values. 
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(5) Branch Instructions 

Instructions which affect the normal sequential 
flow of control in a program by modifying the 
value of PC. 

(6) Interrupt handling instructions 

Instructions used to handle so-called interrupts 
which usually arise from peripheral devices in 
the system. Interrupts are described in Chapter 
8. 

(7) Miscellaneous instructions 

Any other instructions which don 't fit under the 
above headings. 

Many data movement, arithmetic, logic and test 
instructions have the effect of setting or unsetting 
particular bits in the condition code (CC) register. In 
particular, if the result of executing an instruction 
is zero, the zero (Z) flag in CC is always set. If the 
result is negative, the negative (N) flag in CC is 
always set . 

Arithmetic, logic and test instructions may also 
change the value of the carry (C) flag, the half- 
carry (H) flag and the overflow (V) flag in the 
condition code register. Some of these are described 
later in this chapter under the appropriate headings. 
This description is not complete - full details of how 
instructions affect CC flags are provided in Appendix 
1. 

In the following description of the M6809 assembly 
code instructions, it is sometimes necessary to refer 
to particular CC flags. We use a dot notation, 
CC.<flag letter>, to make these references. Thus CC.N 
is the negative flag, CC.V is the overflow flag, etc. 
When we say a flag is set this means that its value is 
1, when unset the flag value is zero. 

In the remainder of this section and in subsequent 
chapters, we sometimes use BASIC statements to explain 
the meaning of assembly language instructions. We have 
done this informally until now but, from now on, we 
will use the following conventions . 

(1) Registers are indicated by BASIC variables with 
the same name as the register. Therefore, the 
names of the registers are A, B, D, X, Y, U, S, 
DP, CC, and PC. 

(2) The use of some other BASIC name refers to the 
location in memory which has that symbolic name. 
Therefore an assembly code instruction, LDD XVAL, 
might be commented with the BASIC statement, D = 
XVAL. 
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(3) When an absolute address in memory is referenced, 
we consider memory as a one-dimensional array 
called MEM and use the absolute address as an ar- 
ray index. Therefore, MEM(A034) refers to the 
memory location whose address, in hexadecimal, is 
A034 . We also use the same notation when refer- 
ring to an indexed address. The register name 
plus or minus any offset is stated as an index 
into MEM. Thus, MEM(X +10) means the memory lo- 
cation whose address is computed by adding 10 to 
the contents of register X. In all cases, con- 
stant values used as indices to MEM are hexade- 
cimal constants. 

Operations using a 16-bit register result in 2 bytes 
being loaded or stored from memory whereas 8-bit 
register operations result in a single byte being 
loaded or stored. We do not explicitly distinguish 
between 1 and 2 byte memory operations in the comments 
accompanying the assembly code examples. 

The examples provided are intended to illustrate the 
assembly code instructions so no machine code 
equivalents are given in this chapter. 



3.1 DATA MOVEMENT INSTRUCTIONS 

The function of data movement instructions in the M6809 
is to transfer information, without change, from 
register to register, from register to memory, and from 
memory to register. In all cases, apart from the EXG, 
register exchange instruction, and some instances of 
the LEA, load effective address instruction, the data 
movement is implemented as a copy operation. That is, 
immediately after the data movement instruction has 
been executed, the source operand and the destination 
operand as specified in the instruction have the same 
value. The value of the source operand is not destroyed 
by the execution of the instruction. 

Data movement instructions have the following form: 

<op-code mnemonicxregister specifier> <parameter> 

The instruction parameter may take different forms 
depending on the particular data movement instruction. 
These will be described along with the individual 
instructions . 

There are a total of 7 types of data movement 
instructions : 

(1) Load instructions 

Instructions which move data from memory to a 
register . 
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(2) Store instructions 

Instructions which move data from a register to 
memory . 

(3) Transfer instructions 

Instructions which move data from one register to 
another. 

(4) Exchange instructions 

Instructions which exchange the contents of one 
register with another . 

(5) Load effective address instructions 
Instructions which compute an operand address and 
load it into an index register. 

(6) Push instructions 

Instructions which push register values onto a 
stack. 

(7) Pull instructions 

Instructions which pull values stored on a stack 
into registers. 



3.1.1 Load instructions 

Load instructions in the M6809 are used to load data 
values into a register from memory or as immediate 
operands from the instruction itself. The general form 
of these instructions is: 

LD<register> <address or immediate operand> 

Registers A, B, D, S, U, X, and Y may be used in load 
instructions . If the instruction specifies a 16-bit 
register (D, U, S, X, T) , the effect of the load 
instruction is to move the addressed memory byte into 
the hi-byte of the register and to load the following 
memory byte (address + 1) into the lo-byte . That is, 2 
memory bytes or a 16-bit immediate operand is moved 
into the register. If an 8-bit register is specified, 
the addressed byte or 8-bit immediate operand is moved 
into the register . 

Four classes of addressing mode are allowed with 
load instructions. These are immediate addressing, 
direct addressing, indexed addressing and extended 
addressing. Depending on the addressing mode used and 
on the particular instruction op-code, load 

instructions are 2, 3, 4, or 5 bytes in length. 

Some examples of load instructions , in assembly 
code, are: 

LDA #10 ; A = 10 
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LDD MAXVAL ; D = MAXVAL 
LDS 10, X ; S = MEM(X + 10) 

LDB $50 ; B = MEMfDPR + 50) 

3.1.2 Store instructions 

Store instructions are the converse of load 
instructions. They are used to transfer information 
from the machine registers to memory. The general form 
of store instructions is: 

ST<register> <address> 

As with load instructions, the allowed registers are A, 
B, D, X, Y, U and S. The use of a 16-bit register name 
results in 2 bytes being moved from the register to 
memory, an 8-bit name results in a single byte being 
moved . 

Allowed addressing modes are direct addressing, 
indexed addressing, and extended addressing. For 
obvious reasons, immediate addressing is not meaningful 
in store instructions. 

Some assembly code examples of store instructions 
are: 

STA I ; MEM(I) = A 

STX ,Y ; MEM(Y) = X 

STD $30 ; MEM (DP + 30) = D 

Like load instructions, store instructions can have 
lengths between 2 and 5 bytes depending on the op-code 
and addressing mode used. 

3.1.3 Transfer instructions 

Transfer instructions move the contents of one register 
to another. Any registers may be specified as long as 
they are of like size, that is, both operands must be 
either 16-bit registers or 8-bit registers. The 
mnemonic for a transfer instruction is TFR and the only 
permitted addressing mode is register addressing. 
Transfer instructions are always 2 bytes in length. 
Examples of transfer instructions are: 

TFR A, DPR ; DPR = A 

TFR X,Y ; Y = X 

3.1.4 Exchange instructions 

The exchange instruction, whose mnemonic is EXG, is 
similar to the transfer instruction described above. 
However, rather than the value of the source register 
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being copied to the destination register, the values of 
the source and destination register are swapped. 

Again, register addressing is the only addressing 
mode which may be used with exchange instructions. For 
example : 

EXG A, DPR ; Temp = A: A = DPR: DPR = Temp 

EXG S,U ; Temp = U: U = S: S = Temp 

3.1.5 Load effective address instructions 
The purpose of the load effective address instructions 
is to set up one of the index registers (S, U, X, Y) to 
hold the absolute address of an operand in memory. 
Because address computations in the M6809 can be fairly 
complex, and hence time consuming, it is sometimes 
useful to carry out this computation once only and then 
use this computed value in subsequent instructions. 
Load effective address instructions have the form: 

LEA<index register> <address> 

The specified address must be an indexed address. LEA 
instructions are either 2, 3, or 4 bytes long depending 
on the particular type of indexed addressing which is 
used. Examples of these instructions are: 

LEAS 10, X ; S = X + 10 

LEAX D,X ; X = D + X 

It is clear from the BASIC representations of the 
instruction functions that, in many cases, the LEA 
operation involves an addition to an index register. 
This means that a subsidiary use of this operation is 
to allow addition and subtraction operations on the 
index registers without requiring that their contents 
be transferred to the accumulator register. For 

example : 

LEAS 10, S ; S = S + 10 

LEAX -20, X ; X = X - 20 

The above operations can, of course, be accomplished 
using the accumulator registers: 

TFR S,D ; D = S 

ADDD 10 ; D = D + 10 
TFR D,S ; S = D 

However, the single LEA instruction executes more 
quickly and takes up fewer memory bytes than these 
instruction sequences. 
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3.1.6 Push instructions 

The function of push instructions is to copy the 
contents of one or more registers onto a stack in 
memory whose top is addressed by the U or the S 
register. Push instructions have the form: 

PSH<U or S> <register list> 

The PSH can move the contents of up to 8 registers (CC, 
A, B, DPR, X, Y, S or U, PC) onto the memory stack. 

Push instructions have a postbyte indicating which 
registers have actually to be pushed onto the stack. 
Individual registers are indicated by bits in the 
postbyte as follows: 



Bit 





CC 


Bit 


1 


A 


Bit 


2 


B 


Bit 


3 


DPR 


Bit 


4 


X 


Bit 


5 


Y 


Bit 


6 


S or U 


Bit 


7 


PC 



Push instructions are always 2 bytes in length. Some 
examples are: 

PSHS A,B ; Push A and B onto the S-stack 

PSHU A, B, Y, X, PC, CC, DPR ; Push all registers apart 
* from U onto the user stack 

The order in which the user specifies the registers in 
the push instruction is not necessarily the order in 
which they are pushed onto the stack. Registers are 
always pushed onto the stack in the following order: 

PC, U/S, Y, X, DPR, B, A, CC 

If all registers are pushed, CC is on top of the stack, 
A is the second top location, B is the third top 
location and so on. If only a subset of the registers 
are pushed onto the stack, the order above is 
maintained although, obviously, only the specified 
registers are actually stacked. 

For example, after executing the instruction PSHU 
A,X,B, the top of the stack is a copy of register A, 
the second top is a copy of register B and the third 
top is a copy of register X although this was not the 
order specified in the instruction. In general, this 
automatic ordering of stacked registers saves the user 
having to care about stacking order. If, however, a 
particular stacking order is required this must be 
achieved by using separate push instructions for each 
register . 
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3.1.7 Pull Instructions 

Pull instructions are the converse of push 

instructions . They move information from stacks in 
memory to specified registers. The form of pull 

instructions is: 

PUL<S or U> <register list> 

Pull instructions , like push instructions , use a 
postbyte to specify which registers are to be pulled 
from the stack. Some examples of pull instructions, 
which are always 2 bytes long, are: 

PULS A,B ; Copy the top 2 locations of the 

* hardware (S) stack to A and B. 

* Adjust the stack pointer accordingly 

PULU A,B,DPR,PC,X,Y,S,CC ; Copy values of all 

* registers from the 

* user stack 

The order in which register values are pulled from the 
stack is again independent of the order in which they 
are specified in the instruction. Therefore, CC is the 
first register pulled, A the next register, B the third 
register and so on . 

3.2 ARITHMETIC INSTRUCTIONS 

The arithmetic instructions available on the M6809 
operate on the accumulator registers and, in some 
cases, directly on memory locations. In all cases when 
an instruction operates on a register one of its 
operands is the value of that register and the result 
of the operation is placed in that register. Therefore, 
after an arithmetic operation on a register the 
previous contents of that register are destroyed. 

There are twelve arithmetic operations available to 
the M6809 programmer which we shall consider in seven 
groups : 

(1) Add instructions 

(2) Subtract instructions 

(3) Clear instructions 

(4) The multiply instruction 

(5) Negate instructions 

(6) The sign extend instruction 

(7) The decimal adjust instruction 



47 

As a side effect of executing most of these arithmetic 
Instructions, flags In the condition code register are 
set. Particular settings are described under the 
appropriate heading below. 

3.2.1 Add Instructions 

There are four kinds of add Instruction provided on the 

M6809. These have the forms: 

ABX X = X + B 

ADC<A or B> Add memory to A or B with CC.C 

ADD<A, B, or D> Add memory location to accumulator 

INC<A or B> Add 1 to register or memory location 

The ABX Instruction Is the simplest add Instruction. 
This Instruction takes the contents of B to be an 
unsigned 8-blt value (0-255) and adds It to X leaving 
the result In X. The condition code flags are not 
affected. This Instruction Is similar In effect to the 
Instruction LEAX B,X but there are important 
distinctions. Firstly, the value of B In an LEA 
Instruction Is taken as an 8-blt two's complement 
number so may take a value between -128 and 127. The 
value of B In an ABX Instruction can range between 
and 255. Secondly, ABX Is a 1-byte Inherent 

address (this means that the Instruction operands are 
always the same) so It Is shorter than the 
corresponding LEA Instruction. The provision of this 
Instruction allows certain kinds of Indexed addressing 
to be Implemented In a very efficient way. 

The add with carry or ADC Instruction operates on 
either accumulator A (ADCA) or accumulator B (ADCB) . 
This Instruction adds the contents of the register plus 
the carry bit CC.C to the specified memory location 
leaving the result In the register. The memory 
location may be addressed using direct, Indexed or 
extended addressing or may be an Immediate value. 

ADC Instructions are used when multiple-byte 
arithmetic Is Implemented where It Is necessary to take 
a carry from a previous arithmetic operation Into 
account . The ADC Instruction affects the C, N, V, Z, 
and H bits of CC. 

Examples of ADC Instructions are: 

ADCA #35 ; A = A + CC.C + 35 

ADCB ,X ; B = B + CC.C + MEM(X) 

Add Instructions operate on registers A, B, and D and 
their function Is to add an Immediate operand or a 
memory location to one of these registers. Like ADC 
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instructions, the C, N, V, Z, and H bits in the 
condition code register are affected by an ADD 
instruction . 

Examples of add instructions are: 

ADDA SVAL ; A = A + MEM(SVAL) 

ADDB #5 / B = B + 5 

ADDD , — Y ; Y = Y- 2 : D = D + MEM(Y) 

The INC instructions are special purpose add 
instructions which are used to add one to the single 
byte accumulators A and B or to a specified memory 
location. Although this operation can be implemented 
in other ways, the 'add 1 to something' operation is so 
common that it is worth providing it as a separate 
machine instruction . 

The instructions INCA and INCB are 1-byte 
instructions with no address field whereas the memory 
increment instruction INC may use direct, indexed or 
extended addressing. For example: 

INCA ; A = A + 1 

INCB ; B = B + 1 

INC FRED ; MEM (FRED) = MEM (FRED) + 1 

The INC operation affects the N, Z and V bits of the 
condition code register. 

3.2.2 Subtract instructions 

There are three types of subtract instruction available 
to the M6809 programmer which are the converse of ADC, 
ADD and INC. These are the instructions SBC (subtract 
with carry) , SUB (subtract) , and DEC (decrement by 1) . 

The function of these instructions is to subtract an 
immediate operand or the value of a memory location 
from a register, leaving the result in that register. 
The operands for this operation must be in two's 
complement form. 

All the subtract operations set the overflow flag 
CC.V if the result is too small to be held in the 
specified register or memory location. They also 

affect the N and Z flags in CC and the instructions SUB 
and SUBC set the carry flag in the event of a borrow 
occurring in the last place of a subtraction. 

The SBC instructions operate on registers A and B 
and subtract CC.C as well as an immediate value or a 
memory location value from the specified register. For 
example : 

SBCA J / A = A - MEM(J) - CC.C 
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SBCB 4,Y ; B = B - MEM(4 + Y) - CC.C 

The subtract Instruction SUB operates on registers A, 
B, or D. For example: 

SUBA #4 ; A = A - 4 

SUBB $30 ; B = B - MEM( 30) 

SUBD POINTER ; D = D - MEM (POINTER) 

The decrement Instruction, DEC, subtracts 1 from an 8- 
blt value held In either A, B or a memory location. 
For example: 

DECA ; A = A - 1 

DECB ; B = B - 1 

DEC CVAL ; MEM(CVAL) = MEM(CVAL) - 1 

3.2.3 Clear Instructions 

The function of clear Instructions (CLR) Is to set 
register A or B or a 1-byte memory location to zero, 
that Is, to clear It of Its previous value. The CLRA 
and the CLRB Instructions are 1-byte Instructions with 
no address field whereas the CLR Instruction may use 
direct, Indexed or extended addressing. 
Examples of clear Instructions are: 

CLRA ; A = 

CLRB ; B = 

CLR A,X ; MEM(A + X) = 

3.2.4 The multiply Instruction 

On most 8-blt microprocessors multiply Instructions do 
not exist . Multiplication Is Implemented by a software 
routine which performs a sequence of repeated additions 
to multiply two numbers. The reason for this Is that 
multiplication Is a relatively complex operation whose 
result Is always twice as long as Its operands. To 
Include this In an 8-blt architecture Increases the 
complexity of that architecture as provision must be 
made for a 16-blt result. 

The Implementation of multiplication by repeated 
addition obviously makes It a relatively slow process 
compared to addition and subtraction. Furthermore, It 
Is a fairly common operation when accessing elements of 
two-dimensional arrays or matrices. As the M6809 Is a 
hybrid microprocessor whose architecture Includes 8-blt 
and 16-blt features, the designers of that chip have 
Included a limited form of multiply Instruction. The 
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multiply instruction, which has the op-code MUL, is a 
1-byte instruction which takes the contents of 
accumulators A and B as its operands and leaves the 
result of the multiplication in accumulator D. As D is 
a catenation of A and B, the original operands are 
destroyed. 

The MUL instruction takes the values in A and B to 
be unsigned 8-bit values rather than two's complement 
numbers. The reason for this is that the use of 
unsigned multiplication makes it easier for the 
programmer to write multi-byte multiplication routines 
for multiplication and that the array element 
computation referred to above generally uses only 
positive array indexes. 

An example of a multiply instruction is: 

MUL ; D = A * B 

3.2.5 Negate instructions 

Negate instructions operate on 8-bit two's complement 
values held in register A, register B or in memory. 
They are written as NEGA, NEGB, or NEG <address>. NEGA 
and NEGB negate the contents of registers A and B 
respectively whereas NEG may use direct, extended or 
indexed addressing. 

Examples of negate instructions are: 

NEGA ; A = -A 

NEGB / B = -B 

NEG SVAL ; MEM(SVAL) = -MEM(SVAL) 

3.2.6 The sign extend instruction 

The sign extend instruction, SEX, is a 1-byte 
instruction whose function is to convert an 8-bit two's 
complement number held in accumulator B into a 16-bit 
two's complement number in accumulator D. In essence, 
it takes the sign bit of B and extends it so that it 
becomes the sign bit of D. The value of the hi-byte 
of D is set up to be the same as the sign bit of B. 
This means that if the number is positive, sign bit = 
0, accumulator A is cleared. If the number in B is 
negative, accumulator A is filled with Is. 

3.2.7 The decimal adjust instruction 

The decimal adjust instruction is used when decimal 
arithmetic, described in section 1.1.4, is used on the 
M6809. The use of decimal arithmetic entails holding 
two 4-bit digits in an 8-bit register rather than an 
8-bit binary number. 

When an add operation is performed on such a value, 
a binary addition takes place so that the numbers held 
in each of the 4-bit register fields need not 
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necessarily be correct . For example, say the numbers 
27 and 53 are added. When represented in 4-bit decimal 
notation these have binary values 00100111 and 01010011 
respectively . When a binary addition is performed, the 
result is 01111010 which cannot be represented as 
decimal as the first digit is 7 and the second is 
hexadecimal A. Clearly, the result of the addition 
should be 80 which in binary form is 10000000. 

The decimal adjust instruction examines register P. 
and also the carry bits CC.H and CC.C. It checks to 
see if an incorrect decimal value is stored in that 
register. If so, it adjusts the decimal digits so that 
the correct value is restored. In the above example, 
it would check bits 0-3 of the number, see that they 
were an impossible decimal number and would convert 
this to the correct number by adding 6 to it. This 
results in a carry into bits 4-7 thus increasing the 
decimal value stored there to 8. The correct number is 
then represented in the register. 

The need for the half-carry bit CC.H now becomes 
clear. If bits 0-3 of the decimal numbers are such 
that an addition generates a value which cannot be 
stored in 4-bits, the half-carry bit is set. The 
decimal adjust instruction recognises this and adjusts 
the decimal digits accordingly. 

3.3 LOGIC INSTRUCTIONS 

Like the M6809's arithmetic instructions, the logic 
instructions are almost exclusively concerned with 
operations on the A and B registers and with individual 
memory bytes. The two exceptions to this art 

instructions which operate on the condition code 
register and which provide a generalised mechanism for 
setting and unsetting individual flag bits in that 
register. 

Logic operations manipulate the individual bits in 
their operands and look upon these operands as simple 
groups of bits (bitstrings) rather than as numeric 
values. For the reader who is unfamiliar with logic 
operations we describe the actual operation as well a: 
the instruction format along with each class of logic 
instruction. 

Logic instructions may be looked upon as falling 
into one of five classes: 

(1) And instructions 

(2) Or instructions 

(3) Complement (not) instructions 

(4) Shift instructions 
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(5) Rotate instructions 

Individual instructions are described under the 
appropriate heading below. 

3.3.1 And instructions 

The logical and operation takes 2 bits as its operands 

and returns a value of 1 if, and only if, both of its 

operands are 1. All possible operands and results for 
this operation are therefore : 

AND -> 

1 AND -> 

AND 1 -> 

1 AND 1 -> 1 

The M6809's and instructions operate on 8-bit data so 
therefore repeat the above operation for all 8-bits in 
the operand register. The registers A, B, and CC may 
take part in and operations . 

The instructions ANDA and ANDB perform a logical and 
on the contents of the named register and a byte in 
memory or an immediate operand. Direct, indexed or 
extended addressing may be used to reference a memory 
byte. 

The ANDCC operation, on the other hand, may only use 
immediate addressing. Its function is to and the CC 
register with the immediate byte provided leaving the 
result in CC . 

Examples of and instructions are: 

ANDA #$F0 ; Ands A with (hex) FO . 

* Note that the effect of this is 

* to clear bits 0-3 in A 

* and to leave bits 4-7 unchanged 

ANDB MASK ; Ands B with MEM (MASK) 

ANDCC #$00 ; Ands CC with (hex) 00 

* This clears CC 

The reader will have gathered from these examples that 
one of the most important functions of the and 
operations is to clear specific bits in a register 
whilst leaving the other bits unchanged. Anding a 
with a 1 bit always clears it whereas anding a 1 with 
either a 1 or a always leaves that value unchanged. 

3.3.2 Or instructions 

There are two types of or instructions provided on the 
M6809. These are so-called inclusive or and exclusive 
or which have mnemonics OR and EOR respectively . 

These operations can be defined by their effect on 
bit values: 





ORA #$0F 


* 




* 




* 






EORB ,X 
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OR -> EOR -> 

1 OR -> 1 1 EOR -> 1 

OR 1 -> 1 EOR 1 -> 1 

1 OR 1 -> 1 1 EOR 1 -> 

Like the and instructions , or instructions are provided 
which operate on registers A, B, and CC . However, 
there is no EORCC instruction - only EORA and EORB are 
available to the programmer . 

Examples of OR and EOR instructions are: 

/ Or (hex) OF with register A 
Note the effect of this is to 
set bits 0-3 of A whilst leaving 
bits 4-7 unchanged 

; Exclusive or B with MEM(X) 

ORCC #$03 ; Or (hex) 03 with CC thus setting 
* bits and 1 in that register 

Just as and instructions can be used to clear specific 
bits in a register, or instructions may be used to set 
specific bits. Oring with a 1 bit always sets the 
corresponding register bit whereas oring with a 
always leaves that bit unchanged. 

3.3.3 Complement instructions 

Complement instructions simply switch the bits in a 
register or memory byte. That is, all 1 bits are set to 
and all bits are set to 1. For example, if B holds 
the bitstring 10010011, executing a COMB instruction 
results in the bitstring 01101100 being stored in B. 

Single byte instructions are available to complement 
registers A and B as is a memory complement instruction 
which may use direct, indexed or extended addressing. 
An alternative name which is sometimes used for the 
complement operation is the 'not' operation. 

Examples of complement instructions are: 

COMA ; Complement register A 

COM B,X ; Complement MEM(B + X) 

The complement operation is not the same as the NEG 
arithmetic operation. The NEG operation forms the two's 
complement of a number whereas the COM operation forms 
the so-called one's complement value. 

3.3.4 Shift instructions 

The purpose of shift instructions is to move all the 
bits in a register along one place to the left or to 
the right with the leftmost or rightmost bit 'falling 
off the end' and being discarded. For example, if a 
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register holds the binary value 10110001 and is shifted 
left, the resultant value is 01100010. If a right 
shift is executed, the resultant value is 01011000. 
Notice that Os are filled in on the left when a right 
shift is executed and on the right when a left shift 
takes place. The M6809's shift instructions fall into 
two classes: 

(1) Arithmetic shift instructions 

Arithmetic shift instructions consider bit 7 of 
the register being shifted to be the sign bit. 
This bit does not take part in arithmetic shift 
right instructions and its value is preserved. 
The bit is shifted during arithmetic shift 
left (ASL) instructions. For example, if a re- 
gister value is 10010011 and an ASL instruction 
using that register is executed, the resultant 
value is 00100110. However, with ASR bits 0-6 are 
shifted with the sign bit propagated into the 
lower bits. The resulting value is 11001001. 

(2) Logical shift instructions 

Logical shift instructions do not recognise the 
sign bit and their operands are shifted to the 
left or to the right as described in the intro- 
duction to this section. Logical shifts have 
mnemonics LSL (logical shift left) and 

LSR (logical shift right) . Notice that the LSL 
and the ASL instructions are equivalent. 

The arithmetic and logical shift instructions operate 
on the A and B registers and on memory bytes accessed 
using direct, indexed or extended addressing. Shift 
instructions always affect the carry bit CC. C whose 
value becomes that of the bit which is shifted out of 
the register. 

Examples of shift instructions are: 

ASIA ; Shift A left by 1 bit with 

* CC.C set to the value of bit 7 

* of A before the shift 

ASRB ; Shift B right by 1 bit with 

* CC.C set to the value of bit 

* of B before the shift 

LSL SVAL ; MEM(SVAL) is shifted left by 

* 1 bit with CC.C set accordingly 

LSR -16, U ; MEM(U-16) is shifted right by 1 bit 

* with CC. C set accordingly 

3.3.5 Rotate instructions 

Rotate instructions are similar to logical shift 
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instructions. The only difference is that the value of 
the carry bit CC. C rather than a is moved to the 
leftmost or rightmost place of the register, depending 
on whether a rotate right or rotate left instruction is 
executed. 

The mnemonics for rotate right and rotate left 
instructions are ROR and ROL respectively and they 
operate on the A or B registers or on a memory byte. As 
usual, direct, indexed or extended addressing may be 
used to refer to this byte in memory. 

Examples of rotate instructions are: 

RORA ; A is shifted right by 1 bit with 

* bit 7 becoming CC.C and CC.C taking 

* the value of bit before the shift 

ROL SVAL ; MEM(SVAL) is shifted left by 1 bit 

* with bit becoming CC.C and CC.C set 

* to the original value of bit 7. 

3.4 TEST INSTRUCTIONS 

The M6809 ' s test instructions allow the programmer to 
determine if certain conditions are true or false. The 
execution of a test instruction always causes one or 
more bits in the CC register to be set or unset 
depending on the result of the test. Thus CC bit 
settings are the means by which test results are 
'remembered' for use by following instructions. 
There are three kinds of test instructions: 

(1) Bit test instructions 

(2) Byte test instructions 

(3) Compare instructions 

Bit test instructions only operate on registers A and B 
and byte test instructions on A, B and memory bytes. 
Compare instructions, however, are available for all 
index and accumulator registers. 

3.4.1 Bit test instructions 

The bit test instructions BITA and BITB are used to 
test if particular bits (0-7) in register A or B are 1 
or 0. The operand of the bit test instruction is a 
single byte called a mask whose value determines which 
bits in the specified register are to be tested. 

In order to test bit n in the register, the mask is 
set up so that only its nth bit is 1 with all other 
mask bits set to 0. Therefore, to test bit 4, the mask 
value should be 10 (hex) and to test bit 6, it should 
be 40 (hex) . 

If the bits being tested are set, the effect of the 
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bit test instruction is to unset the zero flag (Z-flag) 
in the CC register. Recall that this flag is always 
set when the result of an operation is zero and unset 
when the result is non-zero . Bit test is implemented 
as an and operation but without the anded value being 
stored in the specified register. Therefore, if a 
tested bit is 1, CC.Z is and if a tested bit is 0, 
CC.Z is 1. 

Examples of bit test instructions are: 

BITA #$80 ; Tests bit 7 of A 

* CC.Z = not A. 7 

BITB MASK ; Tests the bits of register B 

* according to MEM (MASK) 

3.4.2 Byte test instructions 

Byte test instructions are used to test if a byte in 
memory, register A or register B is positive, negative 
or zero. The mnemonic for these instructions is TST 
with, as usual, A or B appended to it if registers are 
tested. If a memory byte is being tested it may be 
addressed using direct, indexed or extended addressing. 

Byte test instructions are implemented by 

subtracting from the contents of the byte being 
tested. The result of this subtraction causes the 
negative flag and the zero flag in the CC register to 
be set or unset . We have already discussed how the Z- 
flag is set if the result of the previous operation is 
zero so, if the tested byte is zero, CC.Z is set and 
CC.N is unset. 

If the byte tested is positive, both CC.Z and CC.N 
are unset, whereas if it is negative CC.Z is and CC.N 
is 1. In all cases the byte test instruction causes 
the overflow bit CC.V to be unset. 

Examples of byte test instructions are: 

TSTA ; Test register A 

TST 16, X ; Test MEM (16 + X) 

3.4.3 Compare instructions 

Compare instructions allow registers A, B, D, X, Y, S, 
and U to be compared with one or two bytes in memory or 
with an immediate operand. Allowed addressing modes 
are direct, indexed and extended addressing. The 
mnemonic for compare instructions is CMP followed by 
the name of the particular register used in the 
comparison. 

Like byte test instructions, compare instructions 
are implemented as a subtraction with no permanent 
effect on the instruction operands . The addressed 8- 
bit or 16-bit quantity is subtracted from the register 
contents and the carry, overflow, zero and negative 
bits in the condition code are set accordingly. 
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If the value in memory is less than the register 
value, the result of the comparison is positive so CC.N 
is unset . If it is greater than the negative value, 
the result is negative so CC.N is set, and if the 
values are equal, the result of the subtraction is zero 
so CC.Z is set. 

Examples of compare instructions are: 

CMPX [MAXADD] ; Compare X with MEM (MEM (MAXADD) ) 

CMPB #10 ; Compare B with (decimal) 10 

CMPD 16, U ; Compare D with MEM (16 + U) 

Compare instructions are mostly used immediately before 
branch instructions to implement loops, conditions, 
etc. The programmer need not explicitly be aware of 
which bits in CC are set or unset by the compare 
instruction when they are used in this way. 

3.5 BRANCH INSTRUCTIONS 

The M6809 ' s branch instructions are provided to give 
the programmer control over the flow of execution of 
his program. They allow single bits or combinations of 
bits in the condition code register to be tested and, 
on the basis of these tests, add or subtract some value 
from the PC register. This PC modification results in 
a break in the normal sequential execution of machine 
instructions and transfers control to some other 
instruction. 

Branch instructions may be considered under four 
headings : 

(1) Unconditional branch instructions 

These always cause a transfer of control ir- 
respective of the bit settings in the CC regis- 
ter. 

(2) Simple conditional branch instructions 

These test a single bit in the CC register with a 
control transfer dependent on its value. 

(3) Signed conditional branch instructions 

These are used if, in the previous test, signed 
register contents were compared with signed con- 
tents of memory. They test one or more bits in 
CC with control transfers dependent on their 
values . 

(4) Unsigned conditional branch instructions 

These are similar to signed conditional branch 
instructions but are used when unsigned values 
were compared in a previous operation. 
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All branch instructions use PC relative addressing with 
the value to be added to PC held as an 8-bit or 16-bit 
instruction operand. Because the operand may be 1 or 
two bytes, there are 2 forms of every branch 
instruction, a short form and a long form. Short 
branch instructions have the form: 

B<condition> <1 byte 2's complement displacement> 

Long branch instructions have the form: 

LB<condition> <two byte 2's complement displacement> 

In the description and examples below, it is convenient 
for us to show only the short form of the branch 
instructions . However, the reader should bear in mind 
that long branch forms are also allowed. The actual 
machine code value for the long branch form of a branch 
instruction is usually made up by prefixing the 
corresponding short branch op-code with 

10 (hexadecimal ) . Long branch instructions are used 
when the displacement in the branch instruction is less 
than -128 or greater than 127. 

3.5.1 Unconditional branch instructions 

There are three distinct unconditional branch 

instructions available to the M6809 programmer . These 

are: 

BRA Branch always 

BRN Branch never 

BSR Branch to subroutine 

The BRA instruction is equivalent to a BASIC GOTO 
statement and the BSR instruction to a BASIC GOSUB 
statement . These instructions always add their 

displacement to PC irrespective of the settings of CC 
flags. In addition, the BSR instruction, before 

modifying PC, stacks that register on the hardware 
stack referenced by the S register. This means that, 
on return from the subroutine, execution can be resumed 
at the instruction which follows the BSR instruction. 

The BRN instruction is a so-called no-op 
instruction. In short it does nothing at all except 
take up 2 or 4 bytes of space. When this instruction 
is executed, control immediately moves on to the 
following instruction. This may, therefore, appear to 
be a useless instruction. However, it has its uses 
when the programmer wishes to cheat a little and hide a 
1 or 2 byte instruction in the operand field of the BRN 
instruction. After the first execution of BRN when 
this instruction is ignored, it is possible to branch 
back to the hidden instruction and execute it. This, 
however, is poor programming practice and is not a 
recommended technique. 
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3.5.2 Simple conditional branch instructions 

Simple conditional branch instructions examine a single 
bit in the M6809's condition code register. 
Instructions exist which branch on the setting of the 
carry flag, the overflow flag, the negative flag, and 
the zero flag. There are two instructions which test 
each flag. One of these instructions branches if the 
flag is set, the other branches if the flag is unset. 

The table below lists the simple conditional branch 
instructions and shows their association with condition 
code flags. 

Flag Mnemonic Function 

C ECS Branch if carry bit is set 

BCC Branch if carry bit is unset (clear) 

V BVS Branch if overflow bit is set 

BVC Branch if overflow bit is clear 

Z BNE Branch if zero bit is unset 

that is, when comparison operands 
are not equal 
BEQ Branch is zero bit is set 

that is, when comparison operands 
are equal 

N EMI Branch is negative bit is set 

BPL Branch if negative bit is unset 

As with all other branch instructions, these may take 
an 8-bit or 16-bit signed two's complement offset thus 
allowing forward or backward branching. If a 16-bit 
offset is used, the mnemonics above must be prefixed 
with an L to indicate long branching. 

3.5.3 Signed conditional branch instructions 

Signed conditional branch instructions are used when a 
preceding operation has compared the values of signed, 
numeric operands. These branch instructions examine 
combinations of condition code flags to determine if 
the specified condition is true or false and if 
branching should occur. 

The table below shows the four distinct signed 
conditional branch instructions available to the M6809 
programmer. In addition to these, the simple 

conditional branch instructions BEQ and BNE may also be 
used as signed conditional branches, where the branch 
takes place if the operands in the preceding comparison 
were equal or not equal. 

Flag combination Mnemonic Function 

NOT (Z OR (N XOR V) ) BGT Branch if greater than 

NOT(N XOR V) BGE Branch if greater than 

or equal 
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Z OR (N XOR V) BLE Branch if less than 

(N XOR V) BLT Branch if less than 

or equal 

Notice that the pairs of conditions above are 
complementary with the greater than conditions the 
inverse of the less than conditions. BLE is the 
complement of BGT and BGE is the complement of BLT. We 
therefore only explain the flag combinations for a 
single pair of instructions BLE and BLT. 

The BLE instruction branches if, in the preceding 
comparison, the register operand was less than or equal 
to the memory operand. If register A was tested 

against MEM(VAL) say, we might write this as A <= VAL . 
If the operands are equal, the Z-flag in CC is set. 
This flag is examined by BLE and branching occurs if it 
is set . 

If A and MEM (VAL) have the same sign, the 
subtraction operation entailed in the comparison can 
never result in overflow so CC.V is always cleared. If 
A is indeed less than MEM (VAL), the subtraction will 
result in a negative value so CC.N will be set. 
Therefore, if CC.N is set and CC.V unset, this 
indicates that A is less than MEM(VAL) and branching 
will occur. If CC.V is unset and CC.N is unset, A is 
not less than MEM (VAL) . 

In the case where A and MEM (VAL) have different 
signs, the comparison may result in an overflow 
occurring. Thus the sign bit will have an incorrect 
value. If CC.V is set, indicating overflow, and CC.N is 
unset, indicating a non-negative value, this actually 
means that the result is negative. On the other hand, 
if both CC.N and CC.V are set, the result is positive. 

Because of the meanings of these bit combinations, 
the exclusive or operation performed on CC.N and CC.V 
always gives the correct sign bit for the number. 
Therefore, if this operation returns 1, the result of 
the comparison is negative and branching should take 
place. 

The BLT instruction can be considered as a less 
general form of the BLE instruction which only branches 
when the register operand is less than the memory 
operand. The above argument holds for this instruction 
also. The BGT and the BGE instructions are simply the 
complements of these so a not operation performed on 
the corresponding 'less than ' condition bits allows 
these instructions to determine if branching should 
take place. 

3.5.4 Unsigned conditional branch instructions 
Unsigned conditional branch instructions are used when 
the preceding operation compares the values of unsigned 
operands. Again, these instructions test condition 
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code register flag combinations to determine if 
branching should take place. 

The table below shows the four unsigned conditional 
branch instructions and the flags tested in the CC 
register. Again, the BEQ and BNE instructions may be 
used under this category. 

Flag combination Mnemonic Function 

C BLO Branch if lower 

C OR Z BLS Branch if lower or 

the same 

NOT(C) BHS Branch if higher or 

the same 

NOT(C OR Z) BHI Branch if higher 

Again the instruction pairs BLO/BHS and BLS/BHI are 
complementary so we shall only discuss the operations 
BLO and BLS. As these operations assume that the 
previous comparison tested unsigned operands, the 
negative flag CC.N is not tested by these instructions. 
As always, if the result of the comparison is zero, 
CC.Z is set so the BLS instruction branches if this 
flag is 1 . 

As the comparison operands are unsigned, the 
subtraction entailed in the comparison is essentially a 
subtraction of positive values. If the second operand 
is greater than the first, the subtraction will result 
in a borrow. Thus, the carry bit in CC will be set. 
If the second operand (the memory operand) is smaller 
than the first, no borrow will result so the carry bit 
will be unset . Therefore, the BLO and BLS instructions 
examine the carry bit and branch if it is set . 

So far, we have not provided any explicit examples 
of branch instructions as, unlike other instructions 
considered so far, examples of these instructions are 
meaningless in isolation. To illustrate some of the 
branch instructions in use we show below the assembly 
code equivalent to a number of BASIC statements 
involving loops and conditional operations . 

100 IF VI > V2 THEN GOTO 500 

200 IF VI = V2 THEN GOTO 100 

300 VI = VI + 2 

400 GOTO 200 

500 M = VI 

600 GOTO 800 

650 REM ASSUME A SUBROUTINE EXISTS AT 2000 

700 GOSUB 2000 

800 . . . 

Assuming VI, V2 and M are represented as 16-bit signed 
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quantities and that the subroutine at 2000 has the 
symbolic name V1EQ, an assembly code sequence which 
would carry out the same function is: 



D = VI 

Compare this with V2 

If greater than branch 

If equal branch . 
Notice there is no need for 
another load or comparison 

Add 2 to D 

and put result back into VI 
Branch back to comparison 

VI > V2 so M = VI 

continue 

Values equal, call routine 





LDD VI 


f 


CMPLAB 


CMPD V2 


/ 




BGT GTLAB 


/ 


* 


BEQ EQLAB 


N 


* 


ADDD #2 


a 




STD VI 


r 




BRA CMPLAB 


r 


GTLAB 


STD M 


r 




BRA NXTLAB 


r 


EQLAB 


BSR VI EQ 


f 


NXTLAB 







Notice how the assembly code version of the sequence is 
only slightly longer than the BASIC. Whilst, in 

general, BASIC statements expand into multiple assembly 
code instructions it is often possible to eliminate 
much of the redundancy inherent in high level language 
programming and hence produce compact code. 



3.6 



INTERRUPT HANDLING INSTRUCTIONS 



An interrupt is a means by which a program, executing 
on a processor, can be temporarily suspended whilst 
some other program executes . They are of vital 

importance in I/O programming where interrupts are used 
by peripheral devices to inform the processor that data 
are available. The processor must stop what it is 
doing, collect the data from the peripheral then 
restart its original activity . 

The interrupt handling instructions available to the 
M6809 programmer are described in full in Chapter 8 
which covers I/O programming. Here, we simply list the 
interrupt handling instructions which are available and 
summarise their functions. 

(1) The wait instruction 

This instruction, mnemonic CWAI, takes a single 
byte operand which is anded with the contents of 
CC when the instruction is executed. The E flag 
in the condition code register is then set, indi- 
cating that all registers should be stacked on 
the hardware stack. The instruction then waits 
(does nothing) until a hardware interrupt occurs. 
Interrupt processing, as detailed in Chapter 8, 
then commences. 



(2) The return from interrupt instruction 

The return from interrupt instruction, RTI, is 
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executed after Interrupt processing Is complete. 
It unstacks the register values pertaining when 
the Interrupt occurred thus returning control to 
the Interrupted process. 

(3) The software Interrupt Instruction 

This Instruction, which has mnemonic SWI, causes 
a so-called software Interrupt . A software In- 
terrupt causes the processor to jump to an asso- 
ciated Interrupt service routine which may, for 
example, transfer control to some other process. 
Thus the execution of programs In different parts 
of the M6809 ' s memory may be coordinated and syn- 
chronised . 

(4) The synchronise Instruction 

This Instruction, SYNC, Is used to synchronise an 
executing program with some external hardware 
event . 

Interrupt handling Instructions are special purpose 
Instructions and are unnecessary for most applications 
programmed In assembly code. 

3.1 MISCELLANEOUS INSTRUCTIONS 

In this section, we describe the remaining M6809 
machine Instructions which don 't fit neatly Into any of 
the above classifications. There are only four 

Instructions In this category. These are: 

(1) The jump Instruction 

(2) The jump to subroutine Instruction 

(3) The return from subroutine Instruction 

(4) The no operation Instruction 

We shall start with the 'no operation ' Instruction 
which has mnemonic NOP. Its function Is very easy to 
describe - It does nothing. A NOP Instruction Is 1 
byte long and all It does Is take up memory space. This 
can be useful If It Is necessary to force other 
Instructions to occupy particular memory locations. 

3.7.1 Jump Instructions 

The jump Instructions available to the M6809 programmer 
are similar to the branch Instructions discussed 
earlier In this chapter. The function of these 
Instructions Is to evaluate their operand and load Its 
value Into the program counter register. Therefore, If 
addresses of other Instructions are saved as data, you 
can transfer control to these Instructions using a jump 
Instruction . 
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The addressing modes allowed with jump instructions 
are direct, indexed and extended addressing. There are 
two jump instructions JMP, which is an unconditional 
jump, and JSR, which is a jump to subroutine 
instruction. The only difference is that JSR stacks the 
program counter PC on the hardware stack before 
assigning its operand to the PC register. 

Examples of jump instructions are: 

JMP B,U ; PC = MEM(B + U) 

JSR ,U ; S = S - 2: MEM(S) = PC: PC = MEM(U) 

3.7.2 The return instruction 

The return from subroutine instruction, whose mnemonic 
is RTS, is executed as the last instruction in a 
subroutine. It unstacks the top two bytes from the 
hardware stack and assigns them to PC. This 

effectively transfers control to the instruction 
following the BSR or JSR instruction which initiated 
the subroutine. 



Chapter 4 

Introducing assembly 
language 

Assembly language programming is a form of computer 
programming where the programmer writes his program as 
a sequence of absolute directives to the processor. 
That is, he states exactly which machine instructions 
are to be used in the exemption of his program. 

This type of programming is sometimes called low- 
level programming because it is a notation which is 
very close indeed to machine language. By contrast, 
programming in a language such as BASIC is called 
high-level language programming. The programmer writes 
his program at a much higher level where the details of 
the machine architecture are irrelevant. 

High-level programming is much easier than low-level 
programming because machine architectures are 

inherently complex. The low-level programmer must 

master all the details of this complexity if he is to 
avoid making programming errors. The high-level 

programmer, on the other hand, has many fewer details 
to remember and can concentrate on getting the logic of 
his program correct - a difficult enough task in 
itself. 

The majority of computer applications can be 
programmed perfectly adequately in a high-level 
language and there is no point in programming in 
assembly language when BASIC will do . However, in 
personal computers, like the Dragon, there are some 
tasks which are easier to program in assembly language 
rather than BASIC because they require access to 
hardware features of the machine. Although this is 
possible from BASIC, it is clumsy and inconvenient as 
it requires the use of many POKE and PEEK instructions . 

There are also some types of program which, if 
programmed in BASIC, are too slow. This slowness 

results from the way in which BASIC is implemented. 
Every BASIC statement must be translated to machine 
code just before it is executed and this takes a 
significant amount of time. As this translation is 
absolutely essential, the only way to speed these 
programs up is to program them or, at least those 
time-critical parts of them, in assembly code. 

As we have already suggested, the real difference 
between programming in assembly language and 
programming in BASIC is one of detail . In BASIC, 

65 
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decisions about where the program and its data are to 
be located in memory, how real numbers are to be 
provided, how character strings are manipulated, etc. 
are all made for the programmer by the BASIC system. 
As well as this, BASIC programs are expressed in such a 
way that they are readily understood by people whereas 
the notation used for assembly code bears little 
relation to the logical processes involved in solving 
the problem at hand. 

However, in spite of these difficulties, there are 
three fundamental advantages in programming in assembly 
language rather than BASIC: 

(1) The programmer has complete control over the 
machine. If he wishes to use his own particular 
way of manipulating characters or to access 
hardware features in some non-standard way, this 
is possible in assembly language but impossible 
in BASIC. 

(2) Assembly language programs are very much faster 
than equivalent BASIC programs. Because the 
translation phase from BASIC to machine code is 
avoided, assembly language programs typically ex- 
ecute at least 100 times faster and sometimes as 
much as 1000 times faster than corresponding 
BASIC programs. This means that they are suit- 
able for programs, like some arcade-type games, 
which must react very quickly to input from the 
user. 

(3) Assembly language programs are more compact, that 
is, occupy less memory, than their BASIC 
equivalents . This is particularly important when 
large programs are written which may require al- 
most all of the memory available on the machine. 

Of course, there are also disadvantages associated with 
programming in assembly language apart from the obvious 
one that the programmer must remember many low-level 
details of the machine. These disadvantages are: 

(1) Because the programmer has complete control over 
the machine, it is more difficult to detect mis- 
takes in assembly code programs. As long as a 
valid instruction is written, something will hap- 
pen even although the instruction does not do 
what the programmer really wants. Whereas the 
BASIC system has many built-in checks which 
detect errors like dividing by zero, no built-in 
error detection is available to the assembly 
language programmer. 

(2) Because of the low-level nature of assembly 
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language programs and because the programmer must 
explicitly include his own error checking facili- 
ties, assembly language programs are usually a 
good deal longer than their BASIC equivalents. 
This means that they take longer to write, are 
more difficult to understand, and are likely to 
contain more mistakes than high-level language 
programs . 

Because of the complexity of assembly language 
programming, it is best to adopt a multi-stage approach 
when developing a program which is ultimately written 
in assembly code . 

The first stage is to work out the solution to your 
problem in very general terms and to write down this 
solution in some stylised way. This is a very high- 
level expression of what your program ought to do. For 
example, say you are developing a game where the player 
must shoot down alien spacecraft . Part of the general 
high-level expression of this might be: 

if firing button pressed then 

launch missile 
if alien detects missile launch then 

drop anti-missile bomb 
if dodge key pressed then 

move missile to avoid bomb 
else 

missile destroyed 

In fact, this approach is always how we work out the 
logic of programs although, sometimes, we do it in our 
heads rather than explicitly on paper. Writing down 
the solution is much better because when we hold 
detailed information mentally it is very easy to forget 
bits of the problem solution or to make mistakes when 
mentally translating to a programming language. 

The second stage, which is particularly important 
for inexperienced assembly language programmers is to 
translate the general, abstract problem solution into a 
high-level programming language like BASIC. Here, you 
must decide how logical operations such as 'firing 
button pressed' are actually to be implemented. For 
example, in the above program, missile dodge keys might 
be '4' to move left and '6' to move right. We might 
code that part of the solution as : 

KEY$ = INKEY$ 

IF KEY$ = "4" THEN MISX = MISX - 1 

IF KEY$ = "6" THEN MISX = MISX + 1 

where MISX represents the x-coordinate of the missile . 

An advantage of this intermediate stage between 
problem solution and assembly code program is that the 
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BASIC program can sometimes act as a prototype for the 
final program. This lets you try out ideas and debug 
the logic of the solution before becoming involved with 
the details of assembly language. 

The third stage in the development of an assembly 
language program is to take the high-level language 
program and to translate it, by hand, to assembly code. 
This is a straightforward process and the assembly 
language equivalents for BASIC statements are described 
later in this chapter. 

Sometimes it isn 't necessary to translate the 
complete program into assembly code. Typically, most 
programs have relatively small sections, such as a 
display subroutine, where they spend most of their 
time. It is possible to code these time-consuming 
subroutines in assembly language and to link them into 
a BASIC program. This often gives the speed-up effect 
desired by the programmer and the chore of translating 
the whole program into assembly code can be avoided. 
We explain how assembly code subroutines can be linked 
with BASIC programs in Chapter 6. 

In any direct translation of a BASIC program to 
assembly language, there is bound to be redundancy. 
For example, say we have two BASIC statements: 

M = M + 1 

V = V + M 

A direct translation of these into assembly code, 
assuming that both M and V can be held as 8-bit 
integers, is : 



IDA M 
ADDA 1 
STA M 
IDA V 
ADDA M 
STA V 



A = MEM(M) 
A = A + 1 
MEM(M) = A 
A = MEM(V) 
A = A + MEM(M) 
MEM(V) = A 



However, this can be optimised by using the INC 
instruction to add 1 to A. An optimised version of 
this instruction sequence is therefore: 

INC M ; MEM(M) = MEM(M) + 1 

IDA V ; A = MEM(V) 

ADDA M ; A = A + MEM(M) 

STA V ; MEM(V) = A 

The final stage in developing an assembly code program, 
therefore, is to take the BASIC equivalent program and 
to eliminate redundant steps in order to optimise the 
program. Some obvious elimination of redundancy can be 
done during stage three but program rearrangement, the 
use of different addressing modes, etc. should be left 
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until this final stage. In the examples in the 
following chapters we show how optimisation can make a 
considerable difference to the size of a program. 

This chapter and the following two chapters are 
devoted to assembly language programming. In the 

remainder of this chapter, we describe a class of 
program called assemblers . An assembler translates 
instruction mnemonics, symbolic names, etc. used by the 
programmer to machine code. It is a vital tool for the 
serious assembly language programmer. 

The following chapter, Chapter 5, shows how commonly 
used programming constructs such as assignments, loops 
and conditional statements may be programmed in 
assembly language. The approach which we use here is to 
take BASIC statements implementing these constructs and 
show how assembly language equivalents to these can be 
built up. We also show how these ' BASIC-equivalent ' 
programs can usually be optimised to produce a program 
which has improved space and time efficiency. 

Chapter 6 looks at more advanced aspects of assembly 
language programming. In that chapter, we describe a 
general-purpose technique for implementing subroutines 
and we show how character strings may be represented 
and manipulated. We also describe how to link assembly 
language subroutines with BASIC programs and how to 
write assembly code which is position independent. 

It is beyond the scope of this book to discuss 
assembly language programming in great detail . This 
requires a book in itself and, to supplement the 
material here, the reader may find it useful to refer 
to some of the textbooks on M6809 assembly language 
programming which are listed in the reading list . 

4.1 THE ASSEMBLER PROGRAM 

We have already introduced, in earlier chapters, the 
idea of an assembler as a program which translates 
assembly language statements to machine code. This 
translation is not a difficult process as it simply 
requires the program to look up tables of names and 
associated hexadecimal values. However, for humans this 
is a slow, tiresome, error-prone task. In fact, it is 
the kind of job that computers excel at and we 
recommend that you should try to avoid the hand 
translation of assembly code. 

For each machine, there are usually several 
different assemblers available from different 

suppliers . Some of these might have more sophisticated 
features than others but all will provide at least the 
following facilities. 

(1) The translation of mnemonic instructions to their 

equivalent hexadecimal op-codes. 
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(2) The ability to associate labels with assembly 
language statements. Reference to these labels 
within the program will result In the address of 
the labelled statement being substituted for the 
label. 

(3) The association of names with specific memory lo- 
cations. When these variable names are used by 
the programmer, the assembler substitutes the ac- 
tual memory address of the variable. 

(4) The translation of decimal numbers to their hexa- 
decimal equivalent . 

(5) The translation of symbolised address references 
such as [ ,X ] for Indirect Indexed addressing to 
the appropriate postbyte, offset, etc. 

(6) Limited error checking Indicating If an Invalid 
mnemonic has been used, If a label referenced In 
an Instruction Is not declared, If a short branch 
Is used where a long branch Is required, etc. 

The particular assembler whose facilities we shall 
describe In this chapter Is the DREAM assembler, 
available from the manufacturers of the Dragon. This Is 
a typical assembler which uses fairly standard Motorola 
M6809 notation, as set out In Appendix 1, for assembly 
language Instructions. There may be slight differences 
In detail If you use a different assembler but, In 
general, the description of facilities below applies to 
all assemblers which are available for the Dragon. 

The single exception to the standard notation Is 
when Indirect addressing Is used. As the symbols ' [ ' 
and ' ] ' are not Dragon keyboard characters, the DREAM 
assembler uses round brackets ' ( ' and ' ) ' to Indicate 
Indirect addressing. We shall follow this convention 
from now on but the reader who Is using some other 
assembler should read (<address>) as [<address>] . 

As well as being an assembler, DREAM Is also an 
editor. It provides facilities for Inputting, 

modifying, duplicating and saving text on a cassette. 
This text need not be assembly code but may be anything 
at all. However, as the editing and assembling 
facilities are combined, the Implementors of DREAM 
clearly see the creation and editing of assembly 
language Instructions as Its major task. As assembly 
language Instructions do not have explicit line 
numbers, It Is not possible to use the BASIC editor to 
create and edit assembly language programs. 

The standard format for an assembler source line as 
Input to DREAM or any other assembler based on the 
standard Motorola notation Is: 
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<label> <mnemonic> <operand> <comments> 

The different fields in the source line must be 
separated by one or more spaces. The <label> and 
<comments> fields are optional, the <mnemonic> field 
must be present as must the <operand> field except for 
those instructions which use inherent addressing and do 
not require explicit operands. 

4.1.1 The label field 

The label field, if present, must start in the first 
column of the source line. Anything that starts in 
column 1 is therefore taken, by the assembler, to be a 
label . If you make a mistake and put a mnemonic in 
column 1 or a label starting in some other column the 
assembler will get very confused indeed. 

Labels must start with a letter and may only contain 
alphanumeric characters, that is, letters and numbers. 
Most assemblers impose a limit on the length of a label 
- the DREAM assembler, for example, insists that labels 
be no more than 6 characters long. 

The table below shows examples of valid and invalid 
statement labels. 

Valid Labels Invalid Labels 

A372 372A (label must start with a letter) 

NEXTCH NEXTCHAR (label too long) 

OUT IN-OUT (label may not contain '-') 

There is a single exception to the rule in the DREAM 
assembler that labels may contain only alphanumeric 
characters. One label, and one label only, in the 
program may have a ' @ ' as its first character . For 
example, @START or ©BEGIN are valid labels although 
both may not be used in the same program. The label 
whose first character is '@' is one way of indicating 
to the assembler where to start program execution when 
the assembled machine code program is run on the 
Dragon . 

Although the labels A, B, X, Y, U, S, CC, PC, and DP 
are not invalid, you should avoid using them because of 
potential confusion with the M6809 register names. 
Similarly, you should not use labels which are 
identical to assembly language mnemonics. 

4.1.2 The mnemonic field 

The mnemonic field of an assembler input line must 
contain one of the instruction mnemonics that we 
covered in the previous chapter. It must be separated 
from the label field by at least one space. If no 
label is present, the mnemonic field must still be 
preceded by one or more spaces otherwise it will be 
taken as a label . 
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4.1.3 The operand field 

The operand field in an assembly language instruction 
must be present except for those instructions like 
INCA, ABX, MUL, etc. which have no operands. It must be 
separated from the mnemonic field by at least one 
space. The operand field specifies the operand address 
and the following conventions are used when using the 
DREAM assembler to indicate which addressing mode is 
being used. 

Register addressing 

The names of the source and destination registers are 

separated by a comma. For example: 

TFR X,Y 
EXG A, DP 

Immediate addressing 

The immediate value is preceded by a '#' symbol. By 
default, immediate values are decimal but hexadecimal 
values may be input by preceding the value with a ' $ ' 
symbol and character values by preceding them with a 
quote " ' " symbol . It is also possible to associate 
symbolic names with constants and these may also be 
input as immediate values. For example: 

IDA #10 
LDB #$10 
LDA #' + 
IDA #MAXINT 
LDA #LAB1 

If the immediate operand in an instruction is a program 
label, the value substituted for the symbolic label is 
the address of the labelled statement. 

Direct and extended addressing 

In general, the assembler will decide for the 
programmer whether it is best to use direct or extended 
operand addressing. DREAM works out if the addressed 
operand is within a page of the current DP register 
setting and, if so, it generates a direct address. 
Otherwise, an extended address is generated. 

A symbolic name on its own indicates either direct 
or extended addressing as decided by the assembler. 
The programmer may force extended addressing by 
preceding the name with a '> ' character or may force 
direct addressing by preceding it with a '<' character. 
For example: 

LDX VNAME Direct or extended 

LDX >2WM Force extended addressing 

LDX <COUNT Force direct addressing 
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Indexed addressing 

The general form of an indexed address is: 

<offset>, <index register> 

The offset may be a register name, a symbolic name, a 
constant value or may be left out altogether. The 
register name must be X, Y, U or S and, if no offset is 
present, auto increment or decrement may be specified. 

The following examples all show generalised indexed 
addressing. 

LDA BASE,PCR PC relative 

STX OFFST, Y Symbolic constant offset 

STD -16, X Constant offset 

LDA ,X Zero offset 

LDB A, U Register offset 

Auto increment and decrement may only be used with zero 
offset addressing. They are indicated by prefixing the 
index register name with '-' or ' — ' or by suffixing it 
with '+' or '++'. For example: 

STX , Y++ Auto increment by 2 

STA ,S+ Auto increment by 1 

LDB , -Y Auto decrement by 1 

LDD , — S Auto decrement by 2 

In all cases, the assembler works out whether the 
specified offset should be represented as a 5-bit, an 
8-bit or a 16-bit offset. The programmer may force an 
8-bit offset by preceding the offset with a '<" 
character and may force a 16-bit offset by using a '>' 
symbol . It is not possible to force the assembler to 
generate a 5-bit offset. For example: 

LDD <4, X Forces 8-bit rather than 5-bit offset . 

STX >32,Y Forces 16-bit rather than 8-bit offset 

Indirect addressing 

Indirect addressing is indicated by surrounding the 

operand field with round brackets. For example: 

LDA (VALADD) Indirect extended 
STX (A, Y) Indirect indexed 

When using constant values within the operand field, 
the DREAM assembler allows a limited form of arithmetic 
to be used. If constant expressions using '+' and '-' 
are specified, DREAM will carry out the necessary 
arithmetic as it assembles the program. For example: 

LEAS BASE+8, U 
LDD #START -10 
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BRA * + 12 

An asterisk (*) means the value of the program counter 
at the start of the current statement . Notice that 
this is not the same as the actual PC value which 
refers to the next instruction to be executed. 

4.1.4 The comments field 

The comments field is used to provide descriptive 
comment about the associated assembly code instruction. 
It must be separated by at least one space from the 
operand field but the convention when using the DREAM 
assembler is to separate the comments field from the 
remainder of the instruction by two or more spaces and 
to make the first symbol a semi-colon. For example: 

LDA T ; put top value in A 

Comments taking up an entire line may also be 
introduced by placing a '*' in column 1. Most M6809 
assemblers will recognise this as a comment and ignore 
the remainder of the line. For example: 

* An asterisk indicates a comment 

In order to make assembly language statements as 

readable as possible, it is best to adopt a fairly 

rigid, fixed format layout for instructions . The 
following layout is suggested: 

Columns 1-6 Label or blank if statement 

is unlabelled 
Columns 8-11 Mnemonic 

Columns 13-19 Operand 
Columns 22- Comment 

If the operand is more than eight characters long, it 
will obviously overflow into the comments field. 
Depending on the length of the comment, you may either 
continue it on the same line or start a new line with 
'*' and include the comment field on that line. In 
general, when all of a comment cannot fit on the 
instruction line, the continuation on succeeding lines 
should be aligned. 

Examples of this layout are: 

BEGIN LDD MAX / Start with max 

SUBD #1 ; Take 1 off it 

CMPD MINVAL ; Compare with min . 

BEQ VALSEQ 

As with all layout conventions, there are many special 
cases which do not fit well with the convention. 
Slight changes may avoid taking a new line for a short 
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comment continuation or may make the program more 
readable. The programmer must use his common sense in 
this respect and modify the above rules accordingly. 

The output from the DREAM assembler consists of a 
listing of the source lines with each line preceded by 
the address of the corresponding machine instruction 
and the hexadecimal representation of the instruction 
itself. For example, assuming the instruction address 
was 4E40, this might appear: 

4E40 4C INCA ; increment pointer 

4E41 1F8B TFR A, DP ; and load DP 

Notice that the address is incremented according to the 
number of bytes in the instruction. We shall describe 
how the initial assembler address is set up in a later 
section (4.2.5) of this chapter. 

4.1.5 Assembling without an assembler 

If you don 't have an assembler program but want to run 
machine code programs, you have to translate the 
assembly language statements to hexadecimal machine 
code by hand. This is only realistic if you have only 
a few statements to translate and you only do such 
translations fairly occasionally. 

There is enough information in Chapters 2 and 3 and 
in the appendices to allow you to translate from 
assembly language to machine code. You must keep 
careful track of the number of bytes taken up by each 
instruction so that your relative addresses are 
correct. It is best to make a table for yourself of 
the symbolic names which you use and the memory 
addresses which you have assigned to them. 

Once you have completed the translation from 
assembly code to machine code, you then load the 
hexadecimal representations of your machine 

instructions into memory and start executing them. 
This can be accomplished using another program called a 
loader. In the final section of this chapter, we 
provide a listing of a loader, written in BASIC, which 
POKES hexadecimal codes into memory. You may either 
then execute the machine code program with an EXEC 
command or you may include such a command in the loader 
so that the machine code is immediately executed. 

4.2 ASSEMBLER DIRECTIVES 

Assembler directives are instructions used by the 
programmer to give commands to the assembler. They do 
not cause machine instructions to be generated but they 
may alter internal assembler variables. Assembler 
directives are the means by which symbolic names are 
associated with addresses and they also allow the 
programmer to specify the initial values which memory 
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bytes should take before his program Is executed. 

The operation of assembler directives can only be 
understood In the context of the general memory 
organisation which Is assumed by the assembler. Figure 
4.1 shows this organisation for that part of memory 
used by the assembler. 
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Fig. 4.1 Assembler memory map 



There Is a large area of RAM which Is reserved by 
the assembler as Its work space. This workspace 
Immediately follows the machine code of the assembler 
program In the Dragon 's memory. 

At the top of this work space, the assembler creates 
Its own Internal tables which It uses In the 
translation of the programmer's assembly code to 
machine code. As the number of entries In these tables 
depends on the size of the program being assembled, the 
tables are variable In size. As new elements are added 
to the table, they are allocated lower memory 
addresses . Dynamically allocated areas of this sort are 
shown on memory maps as wavy lines with an arrow 
Indicating the direction of growth. 

As an Illustration of how this table Is set up, say 
the top address In the assembler's work space Is 6AFF. 
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The first table entry, which might be 8 bytes long, is 
allocated address GAFF. The following table entry has 
address 6AF8, the one after that 6AF0, and so on . The 
table grows downwards in memory as each succeeding 
element is allocated. 

As the assembly language program is translated, the 
generated machine code must be stored somewhere in 
memory. The area chosen by the assembler for the 
generated machine code is at the bottom of its work 
space and the generated machine code grows upwards in 
memory . 

The assembler uses an internal variable called the 
assembler program counter (APC) to keep track of where 
the next generated machine instruction is to be placed 
in its work space. As instructions are generated, APC 
is incremented by the length of the instruction in 
bytes. Some assembler directives also affect the value 
of APC and their effects are discussed along with the 
description of the directives in question. 

4.2.1 The EQU directive 

The equate directive is the directive which is used to 
associate a symbolic name with a constant decimal or 
hexadecimal value. It has the general form: 

<label> EQU <value> 

It is good programming practice to make extensive use 
of equate directives to name constants used in your 
program. If you chose a name related to the constant ' s 
function, this makes the program easier to understand. 
Furthermore, if you need to change the value of a 
constant, you merely need to change the equate 
directive rather than search through your program 
changing the absolute value every time it is used in an 
instruction. 

Examples of equates defining absolute constant 
values are: 

; maximum allowed integer 
; some table size 
; define a value meaning off 
; a value meaning on 

The constant value in the equate directive may include 
other symbolic constants defined by an equate and may 
also include the symbols ' + ' and '-' . The assembler 
carries out the necessary arithmetic to compute the 
equated value. For example: 



MAXINT 


EQU 


32767 


TABSIZ 


EQU 


100 


OFF 


EQU 


$00 


ON 


EQU 


$FF 



TRUE 


EQU ON 




; TRUE has value $FF 


FALSE 


EQU OFF 




; FALSE = $00 


UTABSZ 


EQU TABSIZ - 


- 15 


; UTABSIZ = 85 
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As well as being used to associate names with program 
constants, the EQU directive may also be used to name 
locations In a memory page when direct addressing Is to 
be used. 

Recall that the direct addressing mode uses the DP 
register to hold the hl-byte of the memory address with 
the lo-byte of the address obtained from the 
Instruction Itself. Not only Is this form of 
addressing space efficient as addresses only take up a 
single byte, It also means that memory locations can be 
reserved for variables In a position Independent way. 

The programmer need not decide the absolute address 
In memory which Is to be allocated to particular 
variables. Rather, he may set up their addresses as a 
displacement from the start of a page. Where that page 
actually resides In memory when the program Is executed 
Is governed by the setting of the DP register which may 
be assigned Immediately before execution. We shall say 
more about position Independence In Chapter 6. 

The equate directive Is used to associate page 
addresses with symbolic names. For example: 

DELAY EQU $00 ; first byte In page 

CURPOS EQU $01 ; CURPOS takes up bytes 1 and 2 

INCH EQU $03 ; byte 3 

The names used In an equate directive must obey the 
normal rules for assembler labels. That Is, they must 
start with a letter, contain only alphanumeric 
characters and may be no more than six characters long. 
The equate directive does not affect the assembler's 
program counter. Names and associated values are 
stored In an Internal assembler table and, when the 
name Is used In a program, Its value Is substituted for 
It. 

4.2.2 The FCB/FCC directive 

The FCB/FCC directive Is used to format data bytes. 
That Is, the programmer uses this directive to allocate 
store and to associate a particular value with each 
byte of that allocated memory. The general form of 
this directive Is: 

[<label>] FCB <value llst> 

The label Is optional and must obey the usual rules for 
assembler labels. If a label Is used, Its value Is 
deemed to be the address of the allocated data byte. 
The value list Is a list of one or more Initial values 
expressed as decimal numbers, hexadecimal numbers or 
character constants. 

In some assemblers, the directives FCB and FCC have 
different meanings with FCB used to format single bytes 
and FCC used to format ASCII character strings. In the 
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DREAM assembler, however, they are equivalent and are 
handled in exactly the same way. Therefore, the 
directive FCB may be replaced by FCC anywhere that it 
is used. 

Examples of FCB directives are: 

* Set up the name of a data area for an error message 

* The first byte holds the length of the message 

* The following characters hold the ASCII characters 

* of the message itself 
* 

ERRl FCB 13, /NO INPUT CHAR/ 
* 

* Notice how strings are delimited by the / character 

* Set up a byte with value IF (hex) 
* 

FCB $1F 

* Set up a 5 byte memory area with bytes initialised 

* to the hex values 8E, 8F, 90,91, and 92 

TAB1 FCB $8E,$8F,$90,$91,$92 

The FCB/FCC directive affects the assembler program 
counter. If APC has the value 5000 say when the FBC 
labelled ERRl above is processed, its value after 
processing is 5000 + 14 (decimal), that is 500D. Note 
that if a value greater than FF (hex) is used with an 
FCB directive only the lo-byte of that value is used in 
the initialisation . 

4.2.3 The FDB directive 

The FDB directive is similar to the FCB directive. 
However, rather than formatting single data bytes, it 
formats 16-bit values taking up 2 bytes (1 word) . It 
general form is: 

[<label>] FDB <value list> 

Examples of FDB directives are: 

DIGITS FDB 1,2,3,4,5,6,7,8,9,0 
MAXVAL FDB 1024 
INSUB FDB GETNUM 

The first two FDB examples above format data words to 
the specified values. In the third example, the 
constant filled in and named INSUB may be the value 
associated with the name GETNUM if GETNUM is defined 
via an EQU directive. Alternatively, if GETNUM is an 
instruction label, the location named INSUB is filled 
in with the address of the labelled instruction. 

This facility allows you to create tables of 



80 

addresses and then use Indirect addressing to access 
the instructions or data whose addresses are kept in 
the table. For example: 

SUBTAB FDB INCHAR, OUTCH, INWRD, 
OUTWRD, RESET, CLOSE 

This directive might be used to create a table of 
subroutine addresses with the subroutine names given on 
the right hand side of the directive. 

Like FCB, FDB affects the assembler program counter, 
incrementing it by two for every word formatted. 

4.2.4 The RMB directive 

The RMB directive is used to reserve one or more memory 
bytes. It does not set them up to any specific value, 
it merely increments APC by the value specified in the 
directive. The general form of an RMB directive is: 

[<label>] RMB <value> 

The value may be either a symbolic, hexadecimal or 
decimal constant . For example : 

INCHAR RMB 1 / reserves a single byte 

OUTBUF RMB 256 ; reserves a 256 byte buffer 

Typically, RMB is used to reserve space which will 
subsequently be allocated values in I/O operations. 

4.2.5 The ORG directive 

The ORG directive is used to assign a value to APC and, 
hence, sets up the logical origin of the generated 
machine code which follows that directive. It is not 
obligatory to include an ORG directive in a program. 
If there is no ORG directive, the DREAM assembler sets 
up its program counter to have an initial value equal 
to the bottom of its work space. 

The general form of an ORG directive is: 

[<label>] ORG <address> 

Examples of this directive are: 

; APC = 5000 (hex) 
; * means current value of APC 
This directive is equivalent 
to RMB 128 

All the examples in this book have been tested with a 
code origin at memory address 4E21 (20001 decimal) . 
This is set up with an ORG $4E21 statement as shown in 
the example in section 4.3 below. 





ORG $5000 


NEWSEG 


ORG * + 128 


* 




* 





81 

4.2.6 The PUT directive 

The PUT directive is used to tell the assembler where, 
in RAM, the generated object code should be placed. It 
is a means of overriding the assembler ' s normal placing 
of generated code at successive addresses starting at 
address 4E21 which is the bottom of its work space. 
The general form of a PUT directive is: 

PUT <address> 

Normally, a PUT directive is preceded by an ORG 
directive to set the APC to the address where the 
generated code is to be placed. This is not 
obligatory, however, if you are going to move the code 
before executing it or if the code is completely 
position independent . 

4.2.7 The SETDP directive 

The SETDP directive is used to tell the assembler the 
current value of the direct page register DP. Remember 
that the assembler decides whether to use direct or 
extended addressing when a symbolic name is used in the 
address field of an instruction. To make this 
decision, it must know the value of DP at that point 
and SETDP is used to provide that information. The 
general form of the directive is: 

SETDP <hex value) 

The operand must be a hexadecimal value in the range 00 
to FF. The SETDP directive only provides information to 
the assembler; it does not cause instructions to be 
generated to assign a value to the direct page 
register. It is the programmer's responsibility to 
ensure that the actual run time value of DP is 
consistent with the value used in a SETDP directive. 

4.3 EXAMPLE PROGRAMS 

In this section we present two complete, working 
programs which the user may type into his machine and 
execute. The first of these programs is a loader 
program, written in BASIC, which allows the user to 
POKE machine code into particular locations in the 
Dragon 's memory. This code may then be executed. 

The other example program is presented in both BASIC 
and assembler. This is a simple program designed to 
illustrate just how much faster machine code programs 
can be . The program fills the display screen with every 
character, one after the other. When the BASIC version 
of the program executes, you will see that this 
operation takes about 2 seconds per screenful. The 
assembly language version fills the screen with each 
character in a fraction of a second. The machine code 
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for the assembly language version of the screen filler 
is included, in hexadecimal, as the DATA statements in 
the BASIC loader. 

Both of these examples are commented and should need 
no further explanation. 

10 ' Machine code loader 

11 ' Machine codes in hex are poked into memory 

12 ' locations starting at 20001 then execed 

20 READ LA ' LA = load address (start of program) 

30 READ EA ' EA = address of first instruction 

40 PA = EA 'to be executed 

50 READ HB$ ' Hex constants 

60 IF HB$="END" THEN 100 

70 POKE PA,VAL("SH"+HB$) ' Poke value into memory 

80 PA = PA + 1 ' Increment address 

90 GOTO 50 

100 PRINT "MACHINE CODE LOADED" 

110 PRINT "LOAD ADDRESS IS " ; LA; " (DEC) " ; 

111 PRINT HEX$ (LA) ; " (HEX) " 

120 PRINT "END ADDRESS IS "; PA-1 ; " (DEC) " ; 

121 PRINT HEX$ (PA-1) ; " (HEX) " 

130 PRINT "EXEC ADDRESS IS" ; EA; " (DEC) " ; 

131 PRINT HEX$ (EA) ; " (HEX) " 

140 PRINT "YOU ARE ADVISED TO SAVE LOADER " 

141 PRINT "BEFORE RUNNING M/C CODE" 

142 'If you want to execute the loaded code 

143 'immediately, you should put an 

144 'EXEC EA statement here. If you do this 

145 'for this program, you lose BASIC print 

146 'information 

150 DATA 20001 'Load address here 

160 DATA 20001 'Execute address here 

165 ' You put your own machine code in hex 

166 ' here to load your hand translated 

161 ' programs 

170 DATA 34,12 ' Machine code for the 

180 DATA 86, 00 ' Screen filler program 

190 DATA 8E, 04, 00 ' given below 

200 DATA A7, 80 

210 DATA 8C, 06,00 

220 DATA 25, F 9 

230 DATA 4C 

240 DATA 81,80 

250 DATA 25, Fl 

260 DATA 35, 92 

270 DATA END 

Program 4.1 BASIC machine code loader 

10 ' Fills screen with characters with codes 

20 ' to 127 in turn 

30 FOR CH = TO 127 

35 ' Screen RAM addresses are from &H400-&H5FF 
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40 FOR SC = &H400 TO SH5FF 
50 POKE SC,CH 
60 NEXT SC 
70 NEXT CH 

Program 4.2 BASIC screen filler 

* SCRFL - fill screen with characters 



* Register Inputs NONE 





ORG $4E21 


SCRFL 


PSHS A,X 




IDA #0 


NXTSC 


LDX #$400 


PRCH 


STA ,X+ 




CMPX #$600 




BLO PRCH 




INCA 




CMPA #128 




BLO NXTSC 




PULS A,X,PC 



Save registers 

First character 

Screen base address 

Store character 

At end of screen? 

No, next character 

Go on to next character 

Do another screenful 
Restore and return 



Program 4.3 Assembly language screen filler 



Chapter 5 

From BASIC to assembly code 



In this chapter we describe the assembly language 
equivalents of the most commonly used BASIC statements. 
As well as the literal translations of BASIC to 
assembly language, we show how these constructs can 
often be implemented in a more efficient way by 
removing some of the redundancy inherent in BASIC. 

The assembly language programmer must obviously know 
the mnemonics for the M6809, the register names and the 
symbolism for the M6809 addressing modes. It may seem a 
daunting task to memorise all this information, 
although it is less so than memorising about 1400 
machine instructions! However, the consistent and 
orthogonal nature of the M6809 ' s instruction set makes 
the task less difficult than might at first be supposed 
and, after a little practice, the programmer will 
easily remember all the mnemonics which he needs. 

The basic building blocks of programs are assignment 
statements, conditional statements, loops and 
statements for input and output of data. We describe, 
in some detail, how each of these may be implemented in 
assembly language. We also cover the declaration and 
calling of BASIC-like subroutines and the 

representation and manipulation of arrays. The 
notation which we use is similar to that used in 
previous chapters. However, if a symbolic name is used 
for a memory location, we use it in comments here as if 
it was a BASIC name - we do not precede it with MEM. 

5.1 ASSIGNMENT STATEMENTS 

Assignment statements in BASIC are used to assign a 
constant, the result of an arithmetic expression or the 
value of a memory location to some other memory 
location. For ease of reference, we may give symbolic 
names to the memory locations involved although, if the 
memory access routines PEEK and POKE are used, we 
actually signify the absolute memory locations to be 
accessed. We describe PEEK and POKE later and 

concentrate here on assignments which have the general 
form: 



<name> = <expression> 
84 
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The <name> on the left side of the = sign may be either 
a variable name or may be a reference to an element of 
an array. The <expression> on the right side of the 
equals sign may be a constant, a variable name, an 
array element reference or an arithmetic expression 
consisting of two or more operands separated by 
arithmetic operators such as + and *. 

Reference to array elements will be dealt with later 
so, in this section, we only describe assignments where 
numeric constants and variables are used. We shall 
make the further simplification that these constants 
and variables may only take 8-bit or 16-bit integral 
values represented as unsigned numbers or in two's 
complement notation . 

This is not too great a limitation as many practical 
applications of computers don't need real numbers. The 
provision of real number arithmetic in most 
microcomputers is made using software routines which 
manipulate pairs of 16-bit quantities representing the 
real number. This is a fairly complex process, and if 
the reader is interested in how it 's done he should 
refer to one of the computer science textbooks 
suggested in the reading list. 

In general, assignment statements on the M6809 are 
implemented using the accumulator registers A, B and 
their catenation D when 16-bit numbers are involved. 
Although it is possible to make use of the index 
registers X, Y, S, and 13, these are usually reserved 
for the storage of addresses. 

The basic outline of an assignment statement in 
assembly language is: 

Evaluate RH expression into an accumulator register. 
Store accumulator in memory. 

For example, the assembly language equivalent of the 
simple BASIC statement M = 7 is: 

IDA #7 / A = 7 
STA M ; M = A 

Notice how immediate addressing is used to specify that 
a constant value is to be loaded into a register. A 
very common mistake made by novice assembly language 
programmers is to forget the # symbol indicating 
immediate addressing. 

IDA 7 ; A = PEEK (7) 

STA M ; M = A 

The BASIC code documenting the assembly language 
instructions shows how this gives a completely 
different result . Rather than a constant value 7 

being loaded into A, the contents of memory byte 
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7 (which may be any value between -128 and 127) are 
loaded into the A register. 

If a constant value between -128 and 127 is being 
assigned, we may use either the A or the B register as 
the accumulator. If the value lies outside this range, 
we must use the D register for the assignment. For 
example, the BASIC statement T = -3842 has the assembly 
language equivalent: 

LDD #-3842 / D = -3842 
STD T ; T = D 

As D is a 16-bit register, the STD operation results in 
information being stored in two consecutive memory 
bytes. If the address of T is 4E22, say, the 
assignment results in the hi-byte of D being assigned 
to 4E22 and the lo-byte being assigned to 4E23. 

Assignments of the form M = N are implemented in 
assembly language in a comparable way: 

IDA N ; A = N 
STA M ; M = A 

If the operands in the assignment T = R are 16-bit 
quantities, the D register must be used: 

I£>D R ; D = R 
STD T ; T = D 

When the right side of the assignment is an arithmetic 
expression consisting, in general terms, of constants, 
variables and arithmetic operators, the assembly 
language programmer must arrange the evaluation of this 
expression in an accumulator. The evaluated value is 
then stored. For example, the assignment statement M = 
N + P has the assembly language equivalent: 

IDA N ; A = N 

ADDA P ; A = A + P 

STA M ; M = A 

Notice that we are ignoring the possibility of overflow 
and carry here. In some arithmetic evaluations, this 
must be taken into account but, as we are simply 
illustrating concepts, we will not introduce this 
unnecessary complication. 

If the assignment uses a mixture of 8-bit and 16-bit 
values, the D register must be used and, in some cases, 
8-bit values will automatically be extended to 16 bits. 
For example, assuming T and R are 16-bit variables, the 
assignment R = T - 10 may be implemented as follows: 

LDD T ; D = T 

SUBD 10 ; D = D - 10 
STD R ; R = D 
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A 16-bit subtraction is automatically carried out in 
this case. However, if mixed 8-bit and 16-bit 
variables rather than constants are used in arithmetic 
expressions, the programmer must be careful not to use 
a D register operation on an 8-bit variable. If such 
an operation is specified, the addressed variable and 
the following memory byte (which is not wanted) will be 
used in the operation. 

For example, say T and R are 16-bit signed 
quantities and M is an 8-bit signed quantity. A 
careless assembly language programmer might translate 
the assignment T = M + R as follows: 

IDD M ; D.hi = MEM(M) : D.lo = MEM(M + 1) 

ADDD R ; D = D + R 
STD T ; T = D 

A completely incorrect value for the addition will 
result because of the IDD operation which does not load 
the 8-bit value of M into D. 

A correct assembly code sequence for this mixed- 
length arithmetic takes into account the fact that the 
lo-byte of D is the B register. The sign extend 
instruction is also used to make sure that the signs of 
the 16-bit and the 8-bit values are the same. 

LDB M ; B = M 

SEX ; Extend sign bit of B to A 

ADDD R ; D = D + R 

STD T ; T = D 

This mixed-length arithmetic becomes more complex when 
a subtraction is involved and the order in which 
operands are loaded into D is significant. Assuming T, 
R, and M have the same values as before, the assignment 
T = R - M cannot be implemented using the same sequence 
as above because the SUBD instruction has no facilities 
for sign extension. 

There are various different ways of implementing 
this type of assignment in assembly language. The 
simplest is to convert the 8-bit value to a 16-bit 
value, store it in some temporary location and then 
perform the subtraction using 16-bit operations only. 
For example: 

LDB M ; B - M 

SEX ; D = B (propagate sign) 

STD , — S / Store M on hardware stack 

* Auto decrement S so that it points to 

* free location on stack 
LDD R ; D = R 

SUBD ,S++ ; D = R - M 

* Note how auto increment used to reset 

* stack pointer 
STD T ; T = D 
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There are no problems in implementing addition and 
subtraction operations in assembly language but 
generalised multiplication and division have no 
corresponding machine instructions. These operations 
must be implemented by calling machine language 
routines and it is beyond the scope of this section to 
explain how these routines may be programmed. 

However, multiplication and division of 8-bit 
unsigned quantities by numbers which are powers of 2 
may be implemented very simply by using the arithmetic 
shift instructions ASR and ASL. Shifting a number left 
n times is equivalent to multiplying it by 2" and 
shifting it right n times is equivalent to dividing 
that number by 2 n . Naturally, the division is an 
integer division operation with the remainder 
discarded. 

For example, if I and J are unsigned 8-bit integers, 
the assignment I = J * 4 might be implemented in 
assembly language as follows: 



IDA J 


; A = J 


ASLA 


; A = A * 2 


ASIA 


; A = A * 2 


STA I 


; I =A 


\ilarly, 


J = 1/8 mig. 


IDA I 


/ A = I 


ASRA 


; A = A/2 


ASRA 


/ A = A/2 


ASRA 


/ A = A/2 


STA J 


/ J = A 



Using shifts to multiply and divide signed quantities 
is more complex because of the need to ensure that the 
sign of the result is correct. We leave it as an 
exercise to the reader to work out how to implement 
signed multiplication and division by powers of 2. 

The PEEK and POKE functions 

The BASIC functions PEEK and POKE allow direct 
reference to individual memory bytes. Whereas PEEK is 
always used as the right hand side of a normal BASIC 
assignment, POKE is a specialised kind of assignment. 
Therefore, T = PEEK(SH0406) assigns the byte value at 
memory address 0406 (hex) to T and POKE ASC ("*"), SH0500 
assigns the code for '*' to the byte in memory at 
address 0500. 

PEEK and POKE are very easily implemented in 
assembly language using load and store instructions. 
The assembly language equivalent of the above PEEK 
instruction is : 

IDA $0406 ; A = MEM(0406) 
STA T ; T = A 
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The POKE operation has the equivalent assembly code: 



LDA #'* 
STA $0500 



A = '*' 
T = A 



The only difference between straightforward assignments 
and PEEK and POKE is that . rather than symbolic 
addresses, absolute memory addresses are used. 



5.2 



CONDITIONAL CONSTRUCTS 



Conditional constructs are fundamental program building 
blocks which allow other statements to be selected for 
execution depending on the truth of some condition. In 
BASIC, conditional execution of statements or groups of 
statements is implemented using IF-THEN statements in 
combination with GOTO statements. 

More generally, conditional constructs can be 
partitioned into three classes: 

(1) Single armed conditionals 
These may be expressed: 

if <condition> then <action> 



(2) 



If the specified condition is true, the <action> 
is executed otherwise it is skipped. 

Two armed conditionals 
These have the form: 



if <condition> then <actionl> else <action2> 

If the given condition is true, <actionl> is exe- 
cuted and <action2> is skipped. If the condition 
is false, <actionl> is skipped and <action2> is 
executed . 

(3) Multi-armed conditionals 

These are really conjunctions of single armed 
conditionals : 



<conditionl> then <actionl> 

<condition2> then <action2> 

<condition3> then <action3> 

<conditionN> then <actionN> 



The conditions are evaluated in turn. If the 
evaluated condition is false, the associated ac- 
tion is skipped and the following condition is 
evaluated. If the condition is true, the associ- 
ated action is executed and the remainder of the 
condition/action pairs are skipped. In BASIC, 



90 

multi-armed conditionals are usually implemented 
as a sequence of IF-THEN statements. 

We shall consider each of these in turn and show how 
they may be implemented in assembly language. The 
approach which we use is to show first how the 
conditional is implemented in BASIC. We then describe 
how this may be literally translated into assembly 
language and finally optimised to remove redundancy. 

5.2.1 Single armed conditionals 

In BASIC, single armed conditionals are expressed as an 
IF-THEN statement if only a single statement is to be 
conditionally executed. If a number of statements are 
to be executed if the condition is true, a goto is used 
to skip over these statements if the given condition is 
false rather than true. 

For example, if we want to swap the values of I and 
J if J is greater than I, we might write the following 
code : 

100 ' Swap if J > I. So skip if J <= I 

110 IF J <= I THEN 200 

120 T = J 

130 J = I 

140 I = T 

200 . . . 

In assembly language programming, we use exactly the 
same technique of reversing the sense of the comparison 
and skipping if this (reversed) condition is true. The 
outline for this is: 

Make comparison setting CC bits 
Branch if NOT desired condition to L 

Code to be executed if original condition true 

L 

Assuming that I and J are unsigned 8-bit values, the 
above BASIC sequence may be translated to assembly 
language as follows: 



LDB J , 
CMPB I , 
BLS L200 , 


B = J 

compare B with I 

if J <= I goto L200 


LDB J , 
STB T , 
LDB I , 


B = J 
T = B 

B = I 


STB J , 
LDB T , 


J = B 
B = T 


STB I , 


I = B 



L200 
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This literal translation may be optimised by noting 
that the first instruction loads the value of J into B 
and the same instruction is repeated after the 
comparison. As comparison does not affect register 
values, the second load is unnecessary. Furthermore, 
we are obliged in BASIC to use an intermediate variable 
T in the swap sequence but in assembly code this is 
unnecessary. We may simply use another register. An 
optimised version of the swap sequence is: 



IDA J 
CMPA I 
BLS L200 
LDB I 
STB J 
STA I 



A = J 

compare A with I 

if A <= J then goto L200 

B = I 

J = B, ie J takes original value of I 

I = A, ie original value of J 



Simple BASIC IF-THEN statements of the form IF P = Q 
THEN P = P + 1 may be directly translated to assembly 
language as follows: 



IDA P 
CMPA Q 
ENE LI 
IDA P 
ADDA #1 
STA P 



Compare A and Q 

if A <> Q then goto LI 

A = P 

A = A + 1 

P = A 



Again, this may be optimised by using the fact that P 
is loaded into a register to evaluate the condition and 
then immediately reloaded after this comparison. This 
second load can be eliminated. We may also use the INC 
instruction to add 1 to a value rather than the add 
instruction. The advantage of this is that INC 
occupies less space and executes more quickly than ADD. 
An optimised form of the above sequence is: 



IDA P 


; A = P 


CMPA Q 


; Compare A and Q 


ENE LI 


; if A <> Q then goto LI 


INCA 


; A = A + 1 


STA P 


; P = A 



LI .... 

In fact, we can reduce the number of instructions still 
further by using the ability of INC to operate on a 
memory location : 



IDA P 
CMPA Q 
ENE LI 
INC P 



LI 
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Assuming direct addressing of both P and Q, the 4 
instruction sequence takes up 8 memory bytes, the 5 
instruction sequence occupies 9 memory bytes and the 
literal translation of the BASIC code takes up 12 
memory bytes. 

5.2.2 Two armed conditionals 

Two armed conditionals are implemented in BASIC by 
using a combination of IF-THEN statements and GOTO 
statements. For example, the condition if <condition> 
then <actionl> else <action2> is written: 

100 IF <condition> THEN 200 
110 <action2> 
120 GOTO 300 
200 <actionl> 
300 .. . 

Notice how we reverse the order of the actions and skip 
over the second action if the condition is true. 
Exactly the same outline structure is used when 
implementing two armed conditionals in assembly 
language . 

Evaluate condition 

Branch if true to LI 

Action2 

Branch unconditionally to L2 

LI Action 1 



For example, if we wish to assign the higher of two 
numbers to some other variable, we might write in 
BASIC: 

100 IF P > Q THEN 200 
110 ' P <= Q here 
120 MAX = Q 
130 GOTO 300 
200 MAX = P 
300 ... 

Given that P, Q and MAX are unsigned values, direct 
translation of this BASIC sequence to assembly language 
gives: 



IDA P 
CMPA Q 
BHI L200 
IDA Q 
STA MAX 
BRA L300 

L200 IDA P 

STA MAX 

L300 



A = P 

Compare A and Q 

if A > Q then goto L200 

A = Q 

MAX = A 

goto L300 

A = P 

MAX = A 
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Again, optimisation of this sequence is possible. The 
statement labelled L200 is a redundant load as A 
already contains the value of P at that point . 
Furthermore, both actions end with an identical store 
operation so it may be factored out and executed after 
one or the other action is complete. An optimised 
version is: 

LDA P 
CMP A Q 

BHI L200 ;if P > Q goto L200 
LDA Q ; A = Q 

L200 STA MAX ; MAX = A 

A sequence of 8 assembly language instructions has been 
optimised to 5 instructions which do exactly the same 
thing. We must emphasise however that it is not good 
programming practice to try to write optimised code 
directly. This is an error-prone process because the 
programmer is liable to become caught up in 
optimisation details and to lose track of the correct 
solution. With high-level language code to serve as a 
master solution, the introduction of errors through 
optimisation is much less likely. 

5.2.3 Multi-armed conditionals 

Multi-armed conditionals are conditional statements 
where several conditions are evaluated and the action 
following the true condition is executed. Readers 
familiar with Pascal will recognise the case statement 
as a form of multi-armed conditional but in BASIC it 
must be implemented as a sequence of IF-THEN 
stat emen t s . For exampl e : 

10 IF T = 7 THEN AGE = BAND1 

20 IF T = 9 THEN AGE = BAND 2 

30 IF T = 14 THEN AGE = BAND3 

40 IF T = 15 THEN AGE = BAND4 
50 

Of course, this may be translated into assembly code as 
a sequence of IF-THEN statements as described above. 
However, multi-armed conditionals often use the same 
value in all tests and often have similar actions with 
different values being assigned to the same variable in 
each action. 

The following structure shows how multi-armed 
conditionals can often be implemented. 

Load test variable 

if NOT (testl) goto T2 

Load value to be assigned 

goto STORE 

T2 if N0T(test2) then goto T3 

Load T2 value 
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goto STORE 

STORE Store value to be assigned 

The above sequence of IF-THEN statements may be coded 
In assembly language: 

IDA T ; Load variable to be tested 

CMPA #7 / First test, compare A with 7 

BNE LI ; If A <> 7 then goto Ll 

LDB BAND1 ; variable to be assigned Into B 

BRA L4 ; Jump to store 

Ll CMPA #9 / Second test, compare A and 9 

BNE 12 ; If not equal, go on to next test 

LDB BAND2 

BRA L4 
L2 CMPA #14 

BNE L3 ; If A <> 14 then goto L3 

LDB BAND3 

BRA L4 
L3 CMPA #15 ; last test 

BNE L5 ; do nothing If not equal 

LDB BAND4 
L4 STB AGE ; assign to AGE 



Compound conditional expressions 

So far, we have looked at conditional statements where 
the condition Involved Is a simple condition of the 
form <operand> <condltlonal operator> <operand>. 
However, compound conditional statements using ANDs and 
ORs to connect conditions are also frequently used. 
These have the general form: 

<slmple condltlon> <loglcal operator> <condltlon> 

where permitted logical operators In BASIC are AND and 
OR. 

In BASIC, therefore, the following are all valid 
conditional expressions: 

P = Q AND T >= R 

J > I AND J < K 

J > I OR K = L 

K = J AND (P > Q OR T >= R) 

When such conditions are Implemented In assembly 
language we may write them so that It Is often only 
necessary to test a single condition rather than the 
conditions on each side of the AND or OR operator. This 
Is possible because we know that both conditions must 
be true for an AND operation to be true and that both 
conditions must be false for an OR operation to be 
false. 
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Therefore, if we test the first condition in an AND 
operation and find it false there is no need to test 
the second condition. Similarly, if we test the first 
condition in an OR operation and find it true, the 
entire expression must be true. The second condition 
need not be tested. For AND operations, the outline 
structure of an assembly language program is: 

Test left hand condition 

If false goto LI 

Test right hand condition 

If false goto LI 

Actions if condition is true 

LI ... 

For OR conditional operators, the outline is similar: 

Test left hand condition 

If true goto LI 

Test right hand condition 

If false goto L2 

LI actions if condition is true 



We illustrate this by showing how BASIC IF-statements 
with compound conditions may be expressed in assembly 
code. Again, assume that all variables are unsigned 8- 
bit quantities. 

IF P = Q AND T >= R THEN M = N 

The assembly language equivalent of this is: 

IDA P ; A = P 

CMPA Q 

BNE OUT ; if P <> Q skip second condition 
IDA T ; A = T 

CMPA R 

BLO OUT ; if T < R skip action 
IDA M 
STA M 
OUT .... 

Notice how only a single test is necessary if P is not 
equal to Q. 

IF (P > Q OR T >= R) AND K = J THEN M = N 

To implement this in assembly language we re-order it 
to test first if K = J. If this is false, there is no 
need to carry out any more tests. 

IDA K ; A = K 

CMPA J 
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BNE 


OUT 


IDA 


P 


CMPA Q 


BHI 


OK 


IDA 


T 


CMPA R 


BLO 


OUT 


IDA 


N 


STA 


M 



If A <> K do no more 

OR condition is true, skip to action 

Skip over action 



OUT 

5.3 LOOP CONSTRUCTS 

Loop constructs are those programming constructs which 
allow the programmer to specify that a group of 
statements is to be executed a number of times. They 
take three fundamental forms: 

(1) For loops 

These execute the loop a specified number of 
times. A loop counter variable is used and the 
loop terminates when this variable reaches a 
specified value. 

(2) While loops 

These execute the statements in the loop while 
some condition remains true. Loop execution stops 
as soon as this condition becomes false. 

(3) Repeat loops 

Repeat loops cause the loop to be executed until 
some condition becomes true. The important dis- 
tinction between repeat loops and while loops is 
that the test for loop termination comes at the 
end of a repeat loop whereas it comes at the be- 
ginning of a while loop. Repeat loops, therefore, 
always execute at least once. 

BASIC provides facilities which allow each of these 
looping constructs to be expressed. For loops are 
constructed using FOR and NEXT statements and both 
while and repeat loops are built from combinations of 
IF-THEN and GOTO statements. 

We shall now look at each of these loop constructs 
in turn and see how they may be expressed in assembly 
language . 

5.3.1 For loops 

For loops are loops which execute a given number of 
times. They have a controlling for-loop variable which 
is incremented or decremented by one or by some 
programmer specified value until it reaches a 
terminating value. For example, consider the following 
BASIC program which sums the integers between 1 and N, 
where N is some positive number. 
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100 TOT = 

110 FOR 1=1 TO N 

120 TOT = TOT + I 

130 NEXT I 

On completion of this program fragment, the value of 
TOT will be the desired sum. To see how this might be 
expressed in assembly code it is best to consider it in 
primitive terms using only IF-THEN and GOTO statements 
to implement looping. 

100 TOT = 

110 1=1 

120 IF I > N THEN GOTO 160 

130 TOT = TOT + I 

140 I = 1+1 

150 GOTO 120 

160 

Now we have reduced the loop to conditionals and gotos 
which we know how to express in assembly language: 

CLR TOT ; TOT = 

LDA #1 ; A = 1 
STA I 
LOOP LDA I ; A = I 

CMPA N 

BHI OUTLP ; IF I > N stop looping 
LDA TOT 
ADDA I 
STA TOT 
INC I ; Notice use of INC rather than ADD 



BRA LOOP 



OUTLP 



In this example we have implemented the statement 1=1 
+ 1 as INC I which appears to be a sensible 
optimisation. However, if we look at the body of the 
loop we see that I is not actually modified in the loop 
body so we can keep the loop counter in a register for 
the duration of the loop. 

CLR TOT ; TOT = 

LDB #1 ; B = 1, loop counter 
LOOP CMPB N 

BHI OUTLP ; if B > N then skip 

TFR B,A ; A = B 

ADDA TOT ; A = A + TOT 

STA TOT ; TOT = A 

INCB ; B = B + 1 

BRA LOOP 
OUTLP .... 

The above code shows how the for loop may be 
implemented when TOT is an 8-bit value. If TOT is a 
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16-bit value, an alternative strategy may be adopted. 
Because of the existence of the register add 
instruction ABX, the B register may be used to hold the 
loop counter and the X register the sub-total as the 
loop is executed. 

LDX #0 ; X = 0, initial total 

LDB #2 / Loop counter 
LOOP CMPB N 

BHI OUTLP ; If B > N then goto OUTLP 

ABX ; X = X + B 

INCB ; B = B + 1 

BRA LOOP ; goto LOOP 

OUTLP STX TOT ; TOT = X 

You can see from these examples that there is no single 
'best ' way of implementing for loops in assembly 
language. Rather, if optimal code is required, the 
programmer must look at the statements within the loop 
and code his loop with how they interact with the loop 
counter. 

As a final example in this section, we show how a 
FOR-NEXT loop using a negative step might be 
implemented in assembly code. This example is also our 
first introduction to arrays . The program fragment 

assigns those numbers between 100 and 50 which are 
divisible by 8 to adjacent array elements. Therefore, 
the first element holds 96, the second 88, the third 80 
and so on. In BASIC, this may be written as follows: 

100 1=0 

110 FOR J = 100 TO 50 STEP -2 

115 RM = J - (INT (J/8) * 8) 

120 IF RM <> THEN 150 

130 ARR(I) = J 

140 1 = 1 + 1 

150 NEXT J 

A completely literal translation of this program is not 
possible because there is no direct equivalent in 
assembly language to the divide operator. However, the 
calculation of the remainder may be simulated by using 
the fact that a binary number which is divisible by 8 
always has its 3 least significant bits (bits 0-2) 
equal to 000. If the bit pattern 00000111 is anded with 
a number and the result is zero then bits 0-2 of that 
number must be 000 and the number is divisible by 8. 

In the assembly language example below, the array 
ARR is accessed by placing the address of its first 
element in register X. Indexed addressing is then used 
to access this and succeeding elements . 

CLR I ; I = 0, not 1 as assembly language 

* array indexes always start at 
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LOOP 



L150 



OUTLP 



LDA #100 
STA J 
LDA J 
CMP A #50 
BLO OUTLP 
ANDA #$F8 
CMP A J 
BNE LI 50 
LDB I 
STA B,X 
INCB 
STB I 
LDA J 
SUBA 2 
STA J 
BRA LOOP 



J = 100 



if J < 50 then goto OUTLP 
AND with bit pattern 11111000 
Compare anded value with original 
if not divisible by 8 goto L150 

Register B holds array index 

1 = 1 + 1 
next J 

J = J - 2 
Back to LOOP 



This code may be optimised by making use of registers 
to hold the value of the loop counter J and the array 
index I. We leave this optimisation as an exercise for 
the reader. 

5.3.2 While loops 

While loops are loops which execute while some 
condition is true. When this condition becomes false, 
execution of the loop terminates. In BASIC, while 
loops are implemented using IF-THEN and GOTO 
statements . 

For example, consider the following while loop: 

count = 
while m > n do 

m = m - n 

count = count + 1 
end while 

In BASIC, this loop might be written: 

100 COUNT = 

110 IF M <= N THEN 150 

120 M - M - N 

130 COUNT = COUNT + 1 

140 GOTO 110 

150 

It is a straightforward task to translate this to 
assembly language using the techniques which we have 
already described for converting IF-THEN and GOTO 
statements to assembly code: 



WLOOP 



CLR COUNT 
LDA M 
CMP A N 
BLS OUTLP 



COUNT = 



If M <= N goto OUTLP 



100 



LDA M 
SUBA N 
STA M 
INC COUNT 
BRA WLOOP 



M = M - N 
COUNT = COUNT + 1 



OUTLP 



As usual, the direct translation of BASIC to assembly 
code may be optimised by removing redundancies and 
making more effective use of the processor registers . 



WLOOP 



* 
* 



OUTLP 



CLRB 
LDA M 
CMP A N 
BLS OUTLP 
SUBA N 



INCB 

BRA WLOOP 
STB COUNT 
STA M 

• * • • 



; Use B to hold COUNT 
; A = M 

; If M <= N goto OUTLP 
; M = M - N. 

Don't store back Into M 
as value is needed 
COUNT = COUNT + 1 

; COUNT = B 

; M = A 



Although there are exactly the same number of 
instructions in this optimised sequence, the number of 
instructions executed within the loop has been reduced 
from 8 to 5. As these are the instructions which are 
each executed several times (once for each loop 
execution) , this reduction means that the optimised 
program will run more quickly than its unoptimised 
equivalent . 

5.3.3 Repeat loops 

Repeat loops and while loops are similar . The most 
important difference is that the test for loop 
termination in a repeat loop comes at the end of the 
loop whereas in a while loop the termination test is 
placed at the start of the loop. The result of this is 
that repeat loops always execute at least once whereas, 
if the while test is initially false, the while loop 
will not execute at all . Again, the BASIC programmer 
uses IF-THEN and GOTO statements to implement repeat 
loops . 

For example, consider the following repeat loop: 

repeat 

m = m + t 

p = p + m 
until p >= n 



In BASIC, this might be written: 
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100 M = M + T 
110 P = P + M 
120 IF P < N THEN 100 

Translating this BASIC program to assembly language 
results in the following program fragment: 

RLOOP IDA M 
ADDA T 

STA M ; M = M + T 

IDA P 
ADDA M 

STA P ; P = P + M 

IDA P 
CMP A N 
BLO RLOOP ; If P < N goto RLOOP 

We leave the optimisation of this assembly code 
sequence as an exercise for the reader. 

5.4 GOTO STATEMENTS 

Although you may never have considered them as such, 
the only function of BASIC GOTO statements is to 
provide a means for the programmer to implement 
conditional statements and loop statements. You will 
have surmised by now that the equivalent, in assembly 
code, to BASIC'S GOTO statement is the unconditional 
branch instruction BRA <label>. 

There is also an alternative form of the BASIC GOTO 
in assembly language and that is the unconditional jump 
instruction JMP . Executing a JMP instruction causes the 
program counter to be set to the value of JMP ' s 
operand. Unlike the BRA instruction where the operand 
is added to or subtracted from PC, JMP ' s operand is not 
a relative but is an absolute value. 

In general, you will probably find that you use BRA 
more often than JMP as it is part of the fundamental 
mechanism involved in the implementation of loops and 
conditional statements. 

5.5 INPUT AND OUTPUT 

One of the most significant advantages of programming 
in a language like BASIC, rather than in assembly 
language, is the fact that BASIC provides easy-to-use 
statements for the input and output of program data. 
Generalised input/output programming is very complex; 
indeed, we devote the whole of Chapter 8 to this topic, 
and the BASIC system hides much of this complexity from 
the programmer. 

In BASIC, we may say INPUT N in order to read a 
number from the keyboard into variable N. Similarly, 
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PRINT N prints the contents of the variable N on the 
display screen. When you think of it however, you 
don 't really type the binary form of a number on the 
keyboard nor do you get the binary pattern representing 
the number printed on the screen. Rather, you type 
characters, which happen to be the digits making up the 
number required, and you read characters on the screen. 

The BASIC system contains routines which convert 
character sequences, say '5' and '8', to the binary 
representation of 58. Similarly, when printing a 
number say -326, the PRINT routine converts the binary 
pattern representing -326 to the characters '-', '3', 
'2' , '6' . 

The assembly language programmer does not have ready 
access to these BASIC conversion routines so must 
always deal with input and output in terms of 
characters rather than numbers. If conversion to and 
from numbers is required, you must write your own 
conversion routines for this task. Some of these 
routines are provided as part of the machine code 
monitor program given in the final section of this 
chapter . 

As I/O programming is described in general in 
Chapter 8, we only describe very basic facilities here 
which allow you to input characters from the keyboard 
and output characters to the screen. These operations 
are carried out by calling subroutines which are an 
inherent part of the Dragon's input/output system. 

We call the routine which is used to input 
characters from the keyboard INCH. The details of how 
this routine works are not important, all the user must 
know is how to call this routine and the results of the 
routine call . When INCH is called, it interacts with 
the keyboard controller and returns an 8-bit value in 
the A accumulator. This value is either zero, which 
means that no key has been pressed, or is a code 
representing the input character. 

The key code returned by INCH is, in most cases, the 
ASCII value of the character typed by the user. The 
exceptions to this, when another value is returned in 
A, are shown in the table below. 



Character 


Hex Code 


Up arrow 


5E 


Shift up arrow 


5F 


Down arrow 


OA 


Shift down arrow 


5B 


Shift @ 


13 


BREAK 


03 


Shift BREAK 


03 


Left arrow 


08 


Shift left arrow 


15 


Right arrow 


09 
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Shift right 5D 

ENTER arrow 0D 

Shift ENTER OD 

CLEAR OC 

Shift CLEAR 5C 

A jump to the starting address of the INCH routine Is 
always stored In memory at address 8006. The INCH 
subroutine can therefore be called directly either by 
using this address as the Instruction operand or by 
equating the name INCH with the address and using INCH 
In the operand field of the Instruction. 

We call the routine using the jump subroutine 
Instruction JSR which pushes the value of PC onto the 
S-stack and jumps to the called routine. On 

termination, the called subroutine restores the value 
of PC. Therefore, a character may be Input as follows: 

JSR INCH 

However, when you actually look for a character using 
INCH there Is no guarantee that a key has been pressed. 
INCH returns In A If no key Is pressed and also sets 
up the condition code register flags. Remember, the Z 
bit In CC Indicates whether the result of the previous 
operation was zero or not so, If CC.Z Is set, this 
means that A = 0. The following short loop continually 
calls INCH until a character Is actually Input. 

GETCH JSR INCH ; Look for a character 

BEQ GETCH ; If none Input, keep looking 

The routine INCH does not destroy any register contents 
apart, obviously, from A and CC. If the value of CC Is 
precious and must be preserved, It must be saved before 
calling INCH and restored after the return from the 
subroutine. For example: 

PSHS CC ; Save CC on S-stack 

GETCH JSR INCH ; get a character 

BEQ GETCH 

PULS CC ; Restore CC 

Normally, It Is not necessary to save and restore CC as 
It should not be used to hold permanent Information. 

INCH'S complement, a character output routine, Is 
accessed via address 800C and the name OUTCH may be 
equated with this address. As well as actually printing 
the character on the screen, OUTCH also moves the 
cursor one space when a character Is printed and 
handles the control characters 'Backspace', 'Return', 
etc. 

To output a character, that character should be 
placed In the A register and OUTCH called. The value 
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of the condition code register is lost when OUTCH is 
called but the values of all other registers, including 
the A register, are not affected. 

The use of OUTCH is illustrated by the following 
example which outputs a '*' at the current cursor 
position . 



IDA #'* 
JSR OUTCH 



A = ASC("*") 
Output character 



Using these simple character input and output routines, 
we may now write an assembly language program which 
reads characters from the keyboard and prints them on 
the display. Assume that the read/print sequence halts 
when the BREAK key is pressed. 



Set location BREAK to 
BREAK key input code 

Get a character 

Is it BREAK 

If so, finish with no print 

Print the character 

Get next character 





IDA #$03 




* 


STA BREAK 


f 

T2 


GETCH 


JSR INCH 


£3 




BEQ GETCH 


F 




CMPA BREAK 


F 




BEQ DONE 


F 




JSR OUTCH 


F 




BRA GETCH 


F 



DONE 



The final example in this introduction to assembly 
language input and output reads 10 characters into a 
memory area then prints them in reverse order. Notice 
how auto increment and decrement of the X register is 
used in this sequence. 

CLRB ; B is counter register 

LDX #CHARS ; Set up address of memory area 
GETCH JSR INCH 

BEQ GETCH ; Get a character 

STA ,X+ ; Store it and increment X 

INCB ; Add 1 to counter 

CMPB #10 ; If counter <= 10 then 

BLS GETCH ; get next character 



* Now all characters are input and the address in X is 

* one greater than the address of the last character 

* in the sequence 

* Count downwards to output them in reverse order 



COUT 
* 



DECB ; Reset B to correct number 

LDA ,-X ; Decrement X 

and fetch character to A 
JSR OUTCH ; Print it 

DECB ; One off counter 

BNE COUT ; If counter <> goto OUTCH 
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5.6 SUBROUTINES 

A subroutine is a self-contained section of code which, 
usually, is set up to implement a particular function. 
Subroutines may be called from within a program. They 
carry out their specified function and control then 
return to the statement following their call. 

Subroutines are a very important programming 
construct and the assembly language programmer has 
great flexibility in how he defines and uses 
subroutines. In fact, much of the next chapter is 
dedicated to this topic and we confine our description 
here to an explanation of how BASIC'S GOSUB command may 
be implemented. 

In BASIC, when we set up or declare a subroutine, we 
assign it a line number which is out of sequence with 
the numbers in the rest of our program. To call the 
subroutine, we set up the values which it needs in 
program variables and then execute a GOSUB <line 
number> instruction. This transfers control to the 
subroutine until a RETURN statement is executed when 
control returns to the calling program. 

For example, the following BASIC sequence calls a 
subroutine to check if a number is an odd number less 
than 20. If so, the subroutine converts it to another 
number by adding 20 to it. Otherwise, it returns the 
number unchanged. The subroutine expects its input to 
be stored in the variable INN and returns its output in 
the variable OUTN. 

100 INPUT INN 
110 GOSUB 1000 
120 PRINT OUTN 

130 

1000 RM = INN - (INT (INN/2) *2) 

1010 IF INN < 20 AND RM = THEN 1040 

1020 OUTN = INN 

1030 GOTO 1050 

1040 OUTN = INN + 20 

1050 RETURN 

When using subroutines in assembly code, we may either 
use the BSR instruction or the JSR instruction. The 
BSR instruction is like the unconditional branch 
instruction BRA, but as well as branching it saves the 
value of PC on the S-stack. The JSR instruction is 
used when we have subroutines set up at known addresses 
or when it is necessary to use indirect addressing to 
call the subroutine. 

Consider how the above BASIC code might be 
translated to assembly language. As we haven't yet 
covered the input and output of numbers, let us assume 
that there exists a subroutine GETNUM which inputs a 
number to the A register and a corresponding routine 
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PUTNUM which outputs the A register, as a number, to 
the screen. 



JSR GETNUM 
STA INN 
BSR CONVON 
IDA OUTN 
JSR PUTNUM 



INPUT A 
INN = A 
To convert number 



; PRINT A 
* CONVON - Add 20 to odd numbers < 20 



CONVON 



EXIT 



IDA INN 
CMPA #20 
BHI EXIT 
BITA #$01 

BEQ EXIT 
ADDA #20 
STA OUTN 
RTS 



; If INN > 20 then goto EXIT 
; Test bottom bit of A 
If it is 0, number is even 

; Add 20 to number 
: and store in OUTN 
; return to calling code 



The RTS instruction is used to return control to the 
instruction which immediately follows the subroutine 
call. As CONVON is called above, the first load 
instruction IDA INN is redundant as INN is already held 
in register A. However, we don 't optimise this by 
removing the load instruction as the subroutine 
specification does not require the programmer to store 
INN in register A before the subroutine call . 

Notice also that the subroutine alters the value of 
register A. In general, subroutines should leave the 
states of registers exactly as they were when the 
subroutine was called. Therefore, all subroutines 
ought to have the following structure. 

Save registers used by subroutine on stack 

Subroutine code 

Restore register values from stack 

Return 

The subroutine CONVON may be adapted to reflect this 
structure : 



CONVON 



EXIT 



PSHS A,CC 
IDA INN 
CMPA #20 
BHI EXIT 
BITA #$01 
BEQ EXIT 
ADDA #20 
STA OUTN 
PULS A,CC,PC 



Save A and CC on stack. 



Restore and return 



All the RTS instruction does is to pull PC from the S- 
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stack so It can be left out If PC Is pulled explicitly 
when the saved registers are restored from the stack. 

This mechanism of passing parameters to and from a 
subroutine In fixed memory locations Is not Ideal . We 
shall describe Its deficiencies and Introduce better 
parameter passing conventions In the following chapter. 

5. 7 ARRAYS 

Arrays are one of the most commonly used data 
structures where a sequence of storage elements Is 
given a name and particular elements In that sequence 
are accessed by number. In this section, we show how 
arrays of numbers may be stored and accessed using 
assembly language. 

In BASIC, the programmer may use one-dimensional 
arrays which are made up of a linear sequence of 
numbers or two-dimensional arrays which, conceptually, 
may be considered as a table or matrix of numbers. In 
fact, two-dimensional arrays are also stored In the 
computer ' s memory as a linear sequence and the BASIC 
system provides routines to map a row/column pair 
(l,m) , say, to the appropriate address n In the linear 
sequence. Two possible mappings which may be used by 
the assembly language programmer are described later In 
this section. 

When using one-dlmenslonal arrays In assembly 
language, you must know the address of the first 
element In the array. You get this by associating a 
label with a 'reserve store ' directive as described In 
section 4.3. This label Identifies the so-called 'base 
address ' of the array. We assume, In the remainder of 
this section, that NARR Is the base address of a one- 
dlmenslonal array of 8-blt numbers and that MATRIX Is 
the base address of a two-dimensional numeric array. 

These may be set up using assembler directives as 
follows : 

NARR RMB 15 

MATRIX RMB 100 

The Index registers X and Y are the mechanism through 
which consecutive array elements may be accessed. The 
base address of the array Is loaded Into one of these 
Index registers and the auto Increment/decrement 
facilities used to sequence through the array. For 
example, say NARR Is made up of 15 8-blt values and you 
want to set all elements to 0. In BASIC, you would 
write : 

100 FOR 1=1 TO 15 DO 
110 NARR(I) = 
120 NEXT I 
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Exactly the same assignments may be specified in 
assembly language but there is no need for an explicit 
counter variable. 



LDX #NARR 
SETO CLR ,X+ 

CMPX #NARR+15 



BLS 



SETO 



; Put array base address in X 

; NARR (X) = : X = X + 1 

; Compare X to base address+15 . 

see if all elements cleared 

; If not, goto SETO 

to clear next element 



The availability of index registers makes array element 
access a very efficient operation. Even when auto 
increment or decrement cannot be used to update the 
index register, because the step is not one or two, the 
LEA instruction may be used to perform arithmetic on 
the index register. 

For example, say the following BASIC code is to be 
implemented in assembly language: 

100 FOR 1=3 STEP 3 to 15 
110 NARR (I) = NARR (I - 1) + 1 
120 NEXT I 



Using assembly language, there is again no need for an 
explicit array index variable: 



LDX #NARR + 2 



* 




* 




SETVAL 


LDA , -X 




INCA 




LEAX 1,X 


* 






STA ,X 




LEAX 3,X 




CMPX #NARR 




BLS SETVAL 



+ 15 



; X = base of NARR + 2 

As NARR+O is first element 

this refers to 3rd element 

; A = Previous element 
; A = A + 1 

; X = X + 1 to get back to 
address to be assigned 
; NARR(X) = NARR(X-l) + 1 
; X = X + 3 
; Are we finished? 

; If not, back to SETVAL 



The use of index registers to hold the address of the 
array element to be accessed is easy to implement for 
one-dimensional arrays . However, when two-dimensional 
arrays are used, the programmer must devise a way of 
storing the array as a linear sequence and must invent 
a mapping to convert a row/column address to an address 
in that sequence. There are two techniques which are 
commonly used for this conversion. 

The first of these techniques stores the entire 
array, row by row, in contiguous memory locations . So, 
if an array is declared in BASIC as MATRIX (10, 10) this 
takes up 100 memory elements. The first 10 elements 
are row 1, written as MATRIX (1, *) , the next 10 are row 
10, MATRIX(2,*), etc. The position of an element in 
row m say is found by finding where row m starts then 
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adding the column displacement to it. 

The starting position of a particular row, the row 
base, is computed by multiplying the row number by the 
length of the row. As the row base of the very first 
row is the same as the array base address, we count row 
numbers from 0. Therefore, to find the row base of the 
sixth row, we actually multiply the row length by five. 
For example, MATRIX (6, *) would have a row base address 
of MATRIX + 50 (5 * row length) and the element 
MATRIX (6, 8) has the address MATRIX +50 + 8. 

An alternative storage technique for two-dimensional 
arrays does not require array rows to be stored 
consecutively nor does it require a multiplication to 
compute the row base address. Rather, the row base 
addresses are all stored separately in another array 
called an Iliffe vector, named after J. Iliffe, the 
inventor of the mapping technique. This is best 
illustrated diagrammatically as shown in Figure 5.1. 



th He Vectoi 



Row 5 



Bow 4 



Row 3 



Bow 2 



Bow 1 



Fig. 5. 1 Using Iliffe Vectors to implement 2-D arrays 



To find out the row base address, the row number is 
used as an index into this Iliffe vector and the 
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starting address of the row is returned. The column 
number is then added to this to compute the actual 
element address. The base address of the array is not, 
in this case, the address of the very first array row 
but is the address of the first element in the Iliffe 
vector. 

The main disadvantage of using Iliffe vectors is, 
obviously, the fact that the Iliffe vector itself takes 
up precious memory locations. However, the flexibility 
which it affords inasmuch as all array rows need not be 
in contiguous storage elements and the fact that a 
multiplication is avoided in the address computation 
often outweighs this disadvantage. 

Both of these techniques of array storage are 
illustrated below with assembly language versions of 
the following BASIC code. 

1 DIM MATRIX (10,10) 
100 INPUT M 
110 FOR J = 1 TO 10 
120 MATRIX (M,N) = 
130 NEXT J 

When MATRIX is stored row by row in a linear sequence, 
the above BASIC may be implemented in assembly code as 
follows. Assume that the subroutine GETNUM inputs a 
number to the A register. 



NEXT 



JSR GETNUM 

DECA 

LDB #10 

MUL 

ADDD #MATRIX 

TFR D,X 

IDA #10 

CLR ,X+ 

DECA 

BNE NEXT 



; INPUT M 

That is, get row number into A 
Subtract 1 as count from 
This is the row length 
D = A * B ie 10*(M-1) 
Add the matrix base address 
Set up index register X 
Use A to count assignments 
Zero element: X = X + 1 
A is counter register 
If A <> goto NEXT 



When the two-dimensional array is represented using an 
Iliffe vector, the array base MATRIX holds the address 
of the first element of that vector. 



NEXT 



JSR GETNUM 

DECA 

LDX #MATRIX 

LDX A,X 

IDA #10 
CLR ,X+ 
DECA 
BNE NEXT 



; A = row number 

; Get displacement from array base 

; Put base address in X 

; Index to load X with the row base 

taken from the Iliffe vector 

; A is counter 

; Set element to zero 

; If all elements not cleared 
go back to clear next element 



Ill 

Notice, from this example, how the powerful indexed 
addressing features of the M6809 makes the computation 
of the row base very efficient indeed. In fact, both 
techniques of two-dimensional array implementation are 
efficient on the M6809. 

5.8 A MACHINE CODE MONITOR 

Rather than present a number of small examples of 
working assembly code programs, we have chosen to 
illustrate the principles described in this chapter 
with a single, substantial assembly code program. 
However, we have written this program in a structured 
way so that it is made up of a number of easily 
understood routines. 

The reason for adopting this approach is that we 
want to present a program which is of use to the novice 
assembly code programmer and which can help him debug 
his own programs. The program below is a so-called 
'monitor' which provides facilities for the user to 
examine the contents of specified memory addresses and 
to change them by typing the revised value. 

The monitor issues a prompt to the user and responds 
to two commands : 

(1) J - this means jump to the start of the user pro- 
gram. 

(2) M <address> - this displays the contents of the 
specified address. 

Once an M command has been issued, the user may examine 
subsequent addresses by typing any letter and may 
examine the previous address by typing an 'up arrow' 
character. If the user types a value made up of three 
decimal digits or two hexadecimal digits preceded by a 
'$' sign, this value is filled in to the current 
address . 

To return to the program which called the monitor, 
you must type a 'BREAK' character. A number is 
normally terminated with an 'ENTER' character but can 
be terminated early with any other character in which 
case, the change is ignored. 

The sequence below is an example of a possible 
dialogue with the monitor. User input is underlined. 

*M $ 1000 

$1000 000 $00 255 

$1001 001 $01 $FF 

$1002 128 $80 2 [ENTER] 

$1003 016 $10 [up arrow] 

$1002 002 $02 $A+ 

$1003 016 $10 [up arrow] 

$1002 002 $02 [BREAK] 
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The monitor program itself now follows. Do not worry if 
you cannot understand it completely on your first 
reading. You may find it helpful to read Chapter 6 and 
then come back to this program for further study. 

* MONITOR - memory examine and change system 

* This program is intended to help with the 

* development and debugging of assembly language 

* programs. It provides facilities for the 

* user to input a memory address and display its 

* contents . These contents may then be modified 

* by the user. 



* Unless otherwise specified, all routines preserve 

* all register values except CC and any registers used 

* for returning results. 

ORG 20001 

LBRA DRAMON ; Entry point of the monitor 
INTRO FCC "DRAGON MONITOR 1.0" 

; Terminator for string 





FCB 


CR 


EQU $0D 


QMARK 


EQU $3F 


UPAROW 


EQU $5E 


BREAK 


EQU $03 


DOLLCH 


EQU $24 


STAR 


EQU $2A 


CBLINK 


EQU $8009 


INCH 


EQU $8006 


OUTCH 


EQU $800C 



Cursor blink routine 
Keyboard input routine 
Output character routine 



* INECHO - read a character and echo it to screen 



* Register inputs NONE 

* Register outputs A - 
INECHO PSHS X,B 
INLOOP JSR CBLINK 

JSR INCH 
BEQ INLOOP 
JSR OUTCH 
PULS X,B,PC 



contains character input 
; Save registers affected 
; Blink the cursor 

; Scan the keyboard 

; and wait for a character 

; Echo the character 

; Restore registers and return 



* OUTSTR - print string of characters 

* Register inputs X - pointer to beginning of string 

* Registers destroyed X,A 



* String must be terminated with a null byte 



OUTSTR 



ENDSTR 



LDA 0,X+ 

BEQ ENDSTR 

JSR OUTCH 

BRA OUTSTR 
RTS 



Get character from string 
Terminated by a zero byte 
Output the character 
and deal with the next one 
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* OUTCR - output a carriage return 

* Register inputs NONE 

OUTCR PSHS A ; Preserve A 

LDA #CR ; Load Carriage Return code 

JSR OUTCH ; and send it 

PULS A, PC ; Restore and return 

* OUTSP - output a space 

* Register inputs NONE 

OUTSP PSHS A 

LDA #$20 ; Code for space 

JSR OUTCH ; and output it 

PULS A, PC 

* READY - Prompt user for new command 

* Register inputs NONE 

READY PSHS A 

BSR OUTCR ; Take a new line 

LDA #STAR / before outputting 

JSR OUTCH ; prompt character 

PULS A, PC 

* 

* DOLLAR - prompt for hexadecimal value 
* 

* Register inputs NONE 

DOLLAR PSHS A 

BSR OUTSP 

LDA #DOLLCH ; Hexadecimal prompt 

JSR OUTCH 

PULS A, PC 
* 

* INHEXD - input a hexadecimal value 
* 

* Register inputs NONE 

* Register outputs A - if valid hex char then hex 

* value else character 

* CC.V = if valid hex character 

* = 1 if non-hex character 

INHEXD BSR INECHO ; Read a character 

CMPA # ' ; and check the range 

BLO INHERR ; for "0" to "9" 
CMPA #'5 

BLS CHOSUB ; and convert if so 

CMPA #'A ; Could be "A" to "F" 
BLO INHERR 
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CHOSUB 



INHEER 
INHXIT 



CMPA #'F 
BHI INHERR 
SUBA #7 
SUBA #'0 
ANDCC #$FD 
BRA INHXIT 
ORCC #2 
RTS 



Make "A" to "F" follow "9" 
Convert to numeric value 
Valid return 

Error return, V bit set 



* OUTHXD - Output hex digit as character 

* Register inputs A - hexadecimal value 



OUTHXD 



ADDCHO 



ANDA #$F 
CMPA #9 
BLS ADDCHO 
ADDA #1 
ADDA #'0 
JSR OUTCH 
RTS 



Mask off MS 4 bits 
Check for decimal digit 

A to F offset 
Convert to character 
and output it 



* INDECD - input decimal digit and convert to value 
* 

* Register inputs NONE 

* Register outputs A - decimal value if in range 0-9 

* - character if non-decimal 

* CC.V - if valid input 

* =1 otherwise 



INDECD 


BSR INECHO 




CMPA #'0 




BLO INDERR 




CMPA #'9 




BHI INDERR 




SUBA #'0 




ANDCC #$FD 




BRA INDXIT 


INDERR 


ORCC #2 


INDXIT 


RTS 


* OUTDCD 
* 


' - output d< 


* Register inputs A 


OUTDCD 


ANDA #$F 




ADDA #'0 




JSR OUTCH 




RTS 



Converts to numeric value 



- decimal value 



* HCNVAB - combine hex digits into single byte 
* 

* Register inputs A - new hex digit 

* B - existing hex digit 

* Register outputs B - new hex value = B*16+A 
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HCNVAB 



STA 0,-S 


; Save for later 


ASLB 


; Move LS 4 bits 


ASLB 


; of B 


ASLB 


; to the 


ASLB 


; MS 4 bits 


ADDB 0,S+ 


; Add in new hex digit 


RTS 





* INHEXB - input a hexadecimal byte 
* 



* 
* 
* 
* 
* 
* 
* 
* 
* 



Register inputs NONE 

Register outputs A - 

CC.C 

CC.V 



INHEXB 



NONHEX 



hex byte value 

= means value is OK 

= means that B contains last 
hex value input 
CC.V = 1 means hex byte terminated 
prematurely and B holds 
character read in. 



CLRB 

BSR INHEXD 
BVS NONHEX 
BSR HCNVAB 
BSR INHEXD 
BVS NONHEX 
BSR HCNVAB 
ANDCC #$FE 
EXG A,B 
RTS 



Initialise to 
Read a hex digit? 

yes, so add to byte 
Second hex digit? 

yes, so add that also 

Indicate OK 

Return with A and B set up 



* OUTHXB - output a hex byte as characters 



* Register inputs A - contains byte value 



OUTHXB 



PSHS A 

LSRA 

LSRA 

LSRA 

LSRA 

BSR OUTHXD 

LDA 0,S 

BSR OUTHXD 

PULS A, PC 



Shift MS 4 bits 
to LS 4 bits 



and output the hex digit 

Get original again 

MS 4 bits masked off by OUTHXD 

Return intact 



* MULB10 - multiply by 10 
* 

* Register inputs B - value to be multiplied 

* Register outputs B = B*10 

* CC.C = means result between 0-255 

* =1 result out of range 
* 



MULB10 



CLR 0,-S 
ASLB 



Create temp on stack 
Evaluate 2*B 
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BCS MULXIT 

STB 0,S 

ASLB 

BCS MULXIT 

ASLB 

BCS MULXIT 

ADDB 0,S 



Too big? 

Save as temp result 

Evaluate 4*B 

Too big? 

Evaluate 8*B 

Too big? 

Evaluate (2*B) + (8*B) 



* If this Is too big a result C will be set 

MULXIT LEAS 1,S / Release temp. 

RTS 
* 

DCNVAB - combine decimal values 



* 
* 



Register Inputs A - new decimal digit 
B - old decimal value 

Register outputs B - result = B*10 + A 

CC.C = - result in range 0-255 
= 1 - result out of range 



DCNVAB 



DCNXIT 



PSHS A 
BSR MULB10 
BCS DCNXIT 
ADDB 0,S 
PULS A, PC 



Save register 
B:=B*10 
Too big? 
B:=(B*10)+A 
Restore and RTS 



* INDECB - Input decimal byte value 



Register inputs NONE 

Register outputs A - input value if valid 

CC.C = value in range 0-255 
=1 value out of range 
If CC.V = 1 then number terminated early so must 
be in range 0-255. B holds last converted digit 
of all 3 typed otherwise set to terminator. 



INDECB 



NONDEC 
IDBXIT 



CLRB 

BSR INDECD 
BVS NONDEC 
BSR DCNVAB 
BCS IDBXIT 
BSR INDECD 
BVS NONDEC 
BSR DCNVAB 
BCS IDBXIT 
BSR INDECD 
BVS NONDEC 
BSR DCNVAB 
BCS IDBXIT 
ANDCC #$FE 
EXG A,B 
RTS 



; Initialise byte 

; Valid digit? 

; yes, add to byte 

/ Too big? 

; Valid digit? 

; yes, add to byte 

; Too big? 

; Valid digit? 

; yes, add to byte 

; Too big, so leave C set 

; Result is in range - 255 

; Return registers 



* OUTDCB - output byte as 3 digit decimal value 



Ill 



* Register inputs A - contains byte to be output 
* 



OUTDCB 



NXTHUN 



TRYTEN 



NXTTEN 



TRYONE 
NXTONE 



OUTONE 



PSHS D 

TFR A,B 

CLRA 

CMPB #100 

BLO TRYTEN 

INCA 

SUBB #100 

BRA NXTHUN 

BSR OUTDCD 

CLRA 

CMPB #10 

BLO TRYONE 

INCA 

SUBB #10 

BRA NXTTEN 

LBSR OUTDCD 

CLRA 

CMPB #1 

BLO OUTONE 

INCA 

DECB 

BRA NXTONE 

LBSR OUTDCD 

PULS D,PC 



Both A and B used 
A is to be used in sub. 
Clear the 100s digit 
Any 100s? 

yes, so update digit 

Subtract a 100 

and try again 

Output the 100s digit 

Set up for 10s 

Any 10s 

yes, so update 10 digit 
Subtract 10 
and try again 
Output 10s digit 
Now count the 1 's 
Any 1 ' s 

yes, update 1 's digit 

Subtract 1 

and try once more 

Final digit 

Restore and return 



HCONVX - Add hexadecimal digit to X 

Register inputs A - new hex digit 

X - old hex value 
Register outputs X = X*16 + A 



HCONVX 



STA 0,-S 

EXG X,D 

ASLB 

ROLA 

ASLB 

ROLA 

ASLB 

ROLA 

ASLB 

ROLA 

ADDB 0,S+ 

EXG D,X 

RTS 



Save away for later use 
So we can do arithmetic 
This performs an ASL 
on the D register 



Have now space in LS 4 bits 
To add in new hex digit 
Restore D and return X 



* INHEXW - input hex word (address) 

* May be up to 4 hex digits 

* Register inputs NONE 

* Register outputs X - hex address value 

* CC.V = 1 address terminated 
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* 
* 
* 
* 

INHEXW 



CC.V = full 4-dlglt address 

read in 

CC.C = value in range O-FFFF 



NONHW 



PSHS D 
I£>X #0 
LBSR INHEXD 
BVS NONHW 
BSR HCONVX 
LBSR INHEXD 
BVS NONHW 
BSR HCONVX 
LBSR INHEXD 
BVS NONHW 
BSR HCONVX 
LBSR INHEXD 
BVS NONHW 
BSR HCONVX 
ANDCC #$FE 
PULS D,PC 



Save from harm 
Initialise address 
Read hex digit? 

yes, add to X 
Read hex digit? 

yes, add to X 
Read hex digit? 

yes, add to X 
Read hex digit? 

yes, add to X 
Result valid 
Restore and return 



* OUTHXW - output hex word as 4 hex digits 

* Register inputs X - value to be output 
* 



OUTHXW 



PSHS D 
TFR X,D 
LBSR OUTHXB 
TFR B,A 
LBSR OUTHXB 
PULS D,PC 



D := hex word 

Output MS byte first (A) 

followed by LS byte (B) 



* MCOMND - memory examine and change 



* Register inputs NONE 

* Registers destroyed X, A, 



CC 



* Interprets user commands as defined in introduction 

Prompt for hexadecimal 
Expecting an address (hex) 
Prefix the address 
with a "$" 

followed by the address 
separate by a space 
Get contents of that address 
Shown as decimal value 
and followed by the 
hexadecimal value 
Then a space 
Assume decimal change 
Too big a number? 
If OK just change the byte 
i, check for hex prefix 



MCOMND 


LBSR DOLLAR 




BSR INHEXW 


EXAMIN 


LBSR OUTCR 




LBSR DOLLAR 




BSR OUTHXW 




LBSR OUTSP 




LDA 0,X ; 




LBSR OUTDCB 




LBSR DOLLAR 




LBSR OUTHXB 




LBSR OUTSP 




LBSR INDECB 




BCS QUERY 




BVC CHANGE 


* A non 


-digit has been type 
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CMPB #DOLLCH ; Hex number? 

BNE CHKCR 

LBSR INHEXB ; yes, so get the rest 

BVC CHANGE ; If OK just change the byte 

* At this point an early end to the number has 

* been typed. Only CR (ENTER) will be allowed. 

* Note: If only a CR is typed then the byte is 

* cleared to zero ! . Be careful ! 
CHKCR CMPB #CR ; CR (ENTER) ? 

BEQ CHANGE ; yes, then change the byte 

* Check for the "up arrow" key since this 

* returns to the previous location. 

CMPB iUPAROW ; "up arrow"? 

BEQ LSTLOC ; yes, move back to last 

* Now check for the BREAK key since this exits 

* the Monitor 



NXTLOC 



LSTLOC 



CHANGE 



QUERY 



MCDXIT 
* 



CMPB #BREAK 
BEQ MCDXIT 
LEAX 1,X 
BRA EXAMIN 
LEAX -1,X 
BRA EXAMIN 
STA 0,X 
CMP A 0,X 
BEQ NXTLOC 
LDA #QMARK 
JSR OUTCH 
BRA EXAMIN 
RTS 



BREAK in? 
yes, then exit 
Move location address on 
and repeat 

Back up location address 
and repeat 
Make the change 
and check afterwards 
OK?, move on if so 
Made a mistake, 
so report it. 

Don't do anything untoward 
Return 



* JCMND - jump to start of program 
* 

* Register inputs NONE 



JCOMND 



JERR 

* 



LBSR DOLLAR 
LBSR INHEXW 
BVS JERR 
JMP 0,X 
RTS 



* DRAMON - main driving 
* 

* Register inputs NONE 

* Registers destroyed X, 

DRAMON LBSR OUTCR 

LEAX INTRO, PCR 
LBSR OUTSTR 

NXTCMD LBSR READY 

LBSR INECHO 
CMPA #'M 
BNE TRYJ 
BSR MCOMND 
BRA NXTCMD 



; Put out $ prompt 

; Get hex address 

; MUST be all 4 hex digits 

/ Only get here on error 
routine 



A, B, CC 



Prompt on a new line 
Output intro. 

Prompt the user 

Read the command 

Memory examine and change? 

yes, then obey it 
and repeat 
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TRYJ 


CMPA #'J 




BNE TRYBRK 




BSR JCOMND 




BRA NXTCMD 


TRYBRK 


CMPA #BREAK 




BNE NXTCMD 




RTS 



Is it the Jump command? 

no, then check for BREAK 

yes, so obey it 

but don 't expect to get here 

Is it the BREAK key? 

no, then prompt again 

yes, return to caller 



Chapter 6 

Subroutines and strings 



When we try to solve a problem, we do not go directly 
from the general statement of the problem to a detailed 
solution unless the problem is very trivial indeed. 
Rather, we split the problem into a sequence of sub- 
problems and work out the individual solutions to these 
smaller problems. The sub-problem solutions are then 
integrated and coordinated to form the general problem 
solution . 

When a problem is intended for computer solution, we 
can use exactly the same approach. The overall problem 
solution is a computer program but, rather than 
generate this as a monolithic code sequence, it can be 
made up of calls to subroutines. Each subroutine is 
the solution to a particular sub-problem. By adopting 
this approach, we reduce the overall complexity of the 
program because we never have to understand or think 
about any more than one subroutine at any one time. 

The idea of a subroutine as a self-contained section 
of code which can be initiated from elsewhere in the 
program was one of the earliest advances in computer 
programming. Subroutines are an essential tool for the 
programmer as they allow him to create 'black boxes ' 
implementing particular functions. Once these have been 
written and tested, the programmer need not be bothered 
how they work as long as he knows their function and 
how to use them. 

To make the most effective use of this problem- 
solving method, the programming language which we use 
must allow us to create subroutines which are 
independent of their environment. Unfortunately, BASIC 
subroutines are very primitive indeed and are not truly 
self-contained. Their disadvantages can be summarised 
as follows: 

(1) BASIC subroutines cannot be made independent of 
their environment because the only way of passing 
information to and returning information from a 
subroutine is through its environment . That is, 
program variables must be used to pass informa- 
tion to and from the subroutine. This means that 
BASIC subroutine libraries cannot be created be- 
cause both the subroutine and the program must 
'agree ' on what variables should be used for 
passing input and output parameters. 
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(2) There is no way, in BASIC, for a subroutine to 
have a completely private data area which no 
other subroutine may tamper with. A private or 
local variable area is essential if the 
subroutine is to be self-contained and if the 
programmer is to be sure that a call of the 
routine always does exactly what 's expected of 
it. 

(3) The BASIC programmer cannot give his subroutine a 
name which reflects its function. Rather, he 
must refer to it by a meaningless line number. 
When a program has many subroutines, it is 
difficult to discern what operations are 
implemented by a sequence of subroutine calls, 
especially if the program is not properly 
commented. 

The subroutine facilities available to the assembly 
language programmer are actually slightly less 
primitive that BASIC'S subroutine mechanism. At least 
in assembly language, a mnemonic name rather than a 
number can be given to a subroutine. As in BASIC, 
there are no built-in mechanisms for passing 
information to and from a subroutine or for 
establishing local data space. 

However, the flexibility of assembly language 
programming is such that the programmer may establish a 
set of conventions which allow local data areas to be 
created and which allow parameters to be passed to and 
from a subroutine without using global variables. 
These conventions provide a more powerful, effective 
and safer mechanism for using subroutines than that 
available to the BASIC programmer. 

In this chapter we show how the M6809 ' s architecture 
is well suited to the implementation of self-contained 
subroutines and we describe a very general way of 
declaring and calling subroutines. We also describe a 
subroutine calling technique which can be used when 
execution speed is the paramount consideration and we 
explain how to construct subroutines which are position 
independent. The final sections of the chapter discuss 
techniques for representing and manipulating character 
strings and we show how assembly language subroutines 
may be integrated with BASIC programs. 

6.1 ASSEMBLY LANGUAGE SUBROUTINES 

We have already shown in section 5. 6 how the BASIC 
GOSUB and RETURN statements can be implemented in 
assembly language using the BSR, JSR, and RTS 
instructions. In that section, we showed how 

parameters could be passed to and from subroutines 
using shared global variables but this is not a 
recommended technique. Furthermore, if it is important 



123 

to produce very efficient code, using shared variables 
for parameter passing has the additional disadvantage 
that It takes time to set up and access these shared 
variables . 

In many cases, there Is no need for separate 
variables to be used for parameter passing. Rather, If 
one or two parameters only are to be passed to and from 
the subroutine, It Is often possible to pass their 
values or addresses In registers. This saves both the 
calling program storing register values and the 
subroutine reloading these values Into registers. 

The use of registers for parameter passing also has 
the advantage that the parameters do not take up memory 
space and that the Impermenent nature of register 
values emphasises that subroutine parameters are 
distinct from other permanent program variables. 

Program 6.1 shows how the A and X registers can be 
used to pass parameters to and from a subroutine. 

* SQUARE - compute square of Input parameter 
* 

* Register Input A - positive number to be squared 

* Register output X - square of Input 

* Method used Is to add n to Itself n times 



SQUARE PSHS B 
TFR A,B 
LDX #0 

SQLOOP ABX 
DECA 



Save B register 

B = A 

Clear X 

X = X + B 

Use A as counter of the 

* number of adds 
BNE SQLOOP 

TFR B,A ; Restore value of A 

PULS B,PC ; Restore B and return 

Program 6.1 SQUARE - compute square of Input 

Notice that a return from subroutine Instruction, RTS, 
Is not required as the program counter Is explicitly 
restored using a PULS Instruction. 

To call this subroutine, the Input parameter must be 
set up In register A. A possible calling sequence might 
be: 

IDA #28 ; Compute 28 squared 

PSHS X ; Save value of X as It Is 

* destroyed by SQUARE 
BSR SQUARE ; Call routine 

STX RESULT ; Store result of call 
PULS X ; Restore X 

Notice how the S-stack Is used to save register values 
which are subsequently restored. Of course, the value 
of X before the call of SQUARE Is not necessarily 



124 

precious. If this is the case there is no need to 
save it before the call and restore it after the 
subroutine has been executed. 

Any of the registers A, B, X, Y, or U may be used to 
pass parameters to and from subroutines. However, the 
S register is never used for this purpose because of 
its role as a system stack pointer. As the return 
address, the value of PC when the routine is called, is 
stacked, it is important that the value in S is not 
corrupted otherwise a proper return from the subroutine 
is impossible. 

In some subroutines it is useful to return an error 
indicator specifying whether or not the subroutine has 
succeeded in its task and the best way to do this is to 
make use of the CC register. The programmer may use 
CC.V or CC.C as error indicators or, alternatively, the 
settings of CC.Z and CC.N may indicate that an event 
has or has not occurred. 

We have already seen an example of how this latter 
method can be used to determine if an input routine has 
returned a character. If a character has been input, 
CC.Z is unset otherwise CC.Z is set. Therefore, the 
following code loops until a character is input: 

GETCH JSR INCH ; Call input routine 

BEQ GETCH 

When using the CC register to return results from a 
subroutine, the ANDCC and ORCC instructions may be used 
to set and unset particular bits in that register. 

Using registers for subroutine input and output 
parameters is an efficient parameter passing technique 
which should be used when subroutine calls must be 
executed as quickly as possible. However, this 
technique requires that the programmer knows exactly 
what registers must be set up when the subroutine is 
called and what registers are used by the subroutine to 
return results. Typically, different subroutines have 
different conventions in this respect depending on the 
number and type of input parameters and on whether they 
return one or more results. The programmer must know, 
in detail, the conventions for each subroutine before 
he can make use of it. 

If there are only a few subroutines used in a 
program, it may be fairly easy to memorise such 
details, but in a large program, where there might be 
tens or even hundreds of subroutines, this is not 
possible . Furthermore, the programmer may wish to build 
up a library of useful subroutines to be included in 
his programs as they are required. It is obviously a 
good idea to have all the subroutines in the library 
used in a consistent way so passing parameters in 
registers is not really suitable. 

There are two different general mechanisms which can 
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be devised to support subroutine parameter passing. 
The first technique, which we do not describe In 
detail, Is to allocate a specified parameter area for 
each subroutine and store the addresses of the 
parameters In that area. When calling the subroutine, 
this area Is set up immediately prior to the subroutine 
call . The address of the parameter area Is assigned to 
an agreed register such as the Y register, and Indirect 
Indexed addressing Is used to access the subroutine 
parameters . 

This technique works well In most cases but cannot 
support so-called recursive subroutines. Recursive 
subroutines are subroutines which contain an embedded 
call to themselves. Although this may seem an unusual 
Idea to the programmer who has only ever programmed In 
BASIC, recursion Is very useful In many situations as 
It allows you to write compact programs which, with 
practice, are easy to understand. Readers who wish to 
experiment with recursive programming should consult 
textbooks which describe data structures such as lists 
and trees to see how recursion Is used. 

The second generalised technique of subroutine 
parameter passing can handle recursive routines. It 
makes use of a stack to pass parameters to and return 
results from subroutines. This technique can be 
Implemented very efficiently on the M6809 because of 
Its built-in stack manipulation Instructions. It Is 
described In detail below. 

6.1.1 Parameter passing using a stack 

The M6809 processor Is designed so that two stacks may 
be used, at the same time, by the assembly language 
programmer. One of these stacks, the hardware or system 
stack, Is referenced via the S register and Is always 
In existence as It Is used to hold the program counter 
when a subroutine Is called. The user stack, or U- 
stack, Is referenced via the U register and may or may 
not be used depending on the application being 
programmed. 

A parameter passing mechanism can be devised which 
uses the S-stack to hold Information such as the 
subroutine return address and which uses the U-stack to 
hold subroutine parameters. This works perfectly well 
and Is often used. It does, however, require 

considerable housekeeping by the calling and called 
routine to make sure that the stacks are always 
consistent . 

The technique which we describe below uses only a 
single stack, the S-stack, but uses two stack pointer 
registers, S and U. As well as being useful to the 
assembly language programmer, this technique of 
subroutine parameter passing Is that used by structured 
high-level languages such as Pascal. 

To understand this parameter passing method, we must 
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introduce the idea of a stack frame. A stack frame is 
a data area which is set up on the stack when a 
subroutine is called. The exact number of bytes making 
up a stack frame depends on the number of subroutine 
parameters, the registers saved by the subroutine and 
the local data space required by the subroutine. 
Figure 6.1 is a diagram of a stack frame in its most 
general form: 



Local 
data 



Saved 
Registers 



Return Address 



Parameters 



Result 



Fig. 6. 1 Stack frame organisation 



The saved registers are those registers which are 
modified by the subroutine. The return address is the 
value of PC stacked by the BSR or JSR instruction. 

The subroutine parameter area is set up by the 
calling program with the values of the subroutine input 
parameters and, if a result is returned by the 
subroutine, the calling program reserves a location on 
the stack for it. 

To illustrate how stack frames are used, consider 
the SQUARE subroutine described earlier in this 
chapter. This is a subroutine which we might wish to 
implement as a function which returns the square of its 
parameter. Assuming that we use the stack for 

parameter passing, we would call the function SQUARE 
using the following instruction sequence: 



* 
* 
* 



LEAS -2,S 



IDA N 
PSHS A 
BSR SQUARE 



; Decrement S by 2. 

As stacks in the M6809 grow downwards 

this leaves a 2-byte 'hole ' in the 

stack for the result 
; A = number to be squared 
; Put parameter onto the stack 
; call SQUARE 



The call of SQUARE pushes PC onto the S-stack. The 
subroutine SQUARE first pushes the registers which it 
uses onto the stack and then sets up a register so that 
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indexed addressing may be used to access the subroutine 
parameters and result . As the X and Y registers are 
often used for array accessing, it is best to use the U 
register as the stack index register set to the base of 
SQUARE'S stack frame. 

Given that the subroutine SQUARE saves the registers 
A, B, X, U, and CC, the stack structure after 
subroutine entry is shown in Figure 6.2. 



decreasing 
addresses 



CC 






A 




B 




X H 




x L 




U H 




u L 




PC H 






PC L 




N 




Result Hi 




Result Lo 





Fig. 6.2 Stack structure after entry to SQUARE 



In general, a called routine should save the value 
of the U register then reset it so that it points to 
the current stack frame. It is important to ensure 
that the U register is set to the same relative 
position in the stack frame for every subroutine but 
the particular location chosen does not matter a great 
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deal. In our examples, the U register Is set so that 
It refers to the hi-byte of the subroutine return 
address on the stack. 

The U register Is assigned after the registers have 
been saved using an LEAU Instruction. As S points at 
the top location on the stack, the stack address 
assigned to U Is computed using the S register value 
and the number of register bytes stacked. 

The code Implementing the subroutine SQUARE Is: 



* SQUARE - returns the square of its input 
* 

SQUARE PSHS A,B,U,X,CC 
LEAU 7,S 
IDA 2,U 



* 
* 

TFR A,B 

LDX #0 
SQLOOP ABX 

DECA 

BNE SQLOOP 

STX 3,U 
* 
* 

PULS A,B,U,X,CC,PC 



; set U register 

; Get parameter from stack 

it is immediately below 

the return address 

; Use repeated addition to 

; square N 

; X = X + B 

; A counts adds 

; Store result 

Result is always immediately 
below parameter on the stack 
; Restore and return 



Program 6.2 SQUARE with stack parameter passing 

On return from the subroutine, the S register is set so 
that it points to the subroutine parameter on the 
stack. As this is no longer required, the calling 
program must increment S to discard the parameter or 
parameters. After this modification of S, S then 
refers to the result returned by the subroutine. 

The complete call/return sequence for SQUARE is 
therefore : 

LEAS -2,S ; Space for result 
LDA N 

PSHS A ; parameter onto stack 

BSR SQUARE ; call routine 

LEAS 1,S ; discard parameter 

PULS D ; result in D register 

* for processing, store, etc 



Obviously, if the subroutine does not return a result, 
there is no need to reserve space on the stack for the 
result. It is, therefore, very important that the 
programmer ensures that each subroutine has an 
associated comment at its head which states the size, 
in bytes, and the type of any result. This is 
essential so that the correct call/return sequence may 
be used for that routine. 
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In general, the call sequence for a subroutine where 
the stack is used for parameter passing is as follows: 

Reserve space, if necessary, for subroutine result 

Evaluate parameters and store on S-stack 

Call subroutine 

Discard parameters 

Retrieve subroutine result from the stack 

The called routine must have an entry and exit sequence 
as follows: 

Save U register and other registers as necessary 

Set up U as stack frame register 

<Body of subroutine> 

Restore registers including PC 

An important advantage of using this technique of 
parameter passing is that the stack may also be used as 
a local variable area for the called subroutine. These 
local variables are accessed using indexed addressing 
via the U or S registers. 

Rather than allocate specific memory locations as 
private working store for the subroutine, it is 
possible to use stack locations for this purpose. This 
store is allocated dynamically on entry to the 
subroutine and de-allocated on exit from the routine. 
Thus store is only allocated when it is required and 
need not be set aside permanently for subroutine local 
variables . 

Program 6.3 takes an array base address and an array 
length as parameters on the stack and returns the 
maximum and minimum values of that array as results. 
It uses local variables to hold the maximum and minimum 
values which have been determined so far. 

* MAXMIN - determines MAX and MIN array values 
* 

* Results are left on the stack in space left 

* by calling routine. 



MAXMIN PSHS U,A,B 





LEAU 4,S 




IDA 2,U 




LDX 3,U 




LDB ,X+ 




PSHS B 




PSHS B 


* 




* 




* 






DECA 




BEQ DONE 


MMLOC 


P LDB ,X+ 



; U points at return address 

• Array length in A 

; address in X 

; 1st element in B 

; Push locals onto stack 
Both MAX and MIN initially set up 
to be the value of 1st element 
MAX=stack (S) , MIN=stack (S+l) 

; If only one element, all done 
; Array element in B 
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CMPB ,S 




BGT NEWMAX 




CMPB 1,S 




BGT ELOOP 




STB 1,S 




BRA ELOOP 


NEWMAX 


STB ,S 


ELOOP 


DECA 




BNE MMLOOP 


DONE 


LDA ,S+ 




STA 5,13 




LDA ,S+ 




STA 6,U 


PULS 


U,A,B,PC 



Compare with MAX 

If greater, re-assign MAX 

Compare with MIN 

Value greater, go on to next 

Otherwise re-assign MIN 

Re-assign MAX 



; Maximum value 
; into result space 
; Minimum value 
; into result space 
Restore and return 



Program 6.3 MAXMIN - find maximum and minimum of 

array 

This technique of local variable allocation allows 
recursive subroutines, subroutines which call 

themselves, to be implemented. When a subroutine calls 
itself, a completely new local variable area is set up 
on the stack and the data area of the calling routine 
is not destroyed. 

We illustrate this using a recursive routine which, 
given an input parameter N, returns the Nth Fibonacci 
number. Fibonacci numbers are numbers in a sequence 
where the value of a given number is computed by adding 
the previous two numbers in the list. The first values 
in the sequence are and 1 so the first 10 Fibonacci 
numbers are: 

1 1 2 3 5 8 13 21 34 

Fibonacci numbers are not just mathematical oddities 
but have practical uses in sorting large data files 
held on magnetic tape. Readers interested in how they 
are used should consult a textbook on sorting 
techniques . 

A general formula for computing the Nth Fibonacci 
number is recursive: 

if N = 1 then 

FIB(N) = 
else 

if N = 2 then 
FIB(N) = 1 
else 

FIB (N) = FIB (N-l) + FIB (N-2) 

So, if the 5th Fibonacci number is required, this 
formula would be evaluated as follows: 



FIB (5) = FIB (4) + FIB (3) 

= FIB (3) + FIB (2) + FIB (2) + FIB(l) 
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= FIB (2) + FIB(l) +1+1 + 
= 1+0 + 1 + 1+0 

= 3 

The assembly code routine below takes an 8-bit input 
parameter N and returns a 16-bit result which is the 
Nth Fibonacci number. As BASIC does not support 
recursion, we cannot first translate our logical 
solution above into BASIC but must go straight to 
assembly code . 



* FIB - Computes Nth Fibonacci number 
* 

* Result left on stack in location P+l where P 

* is parameter address 

* Set up equates to refer to stack locations 



FRES1 EQU 3 

FPARl EQU 2 

FIBL1 EQU -5 

FIBL2 EQU -7 



Result 
Parameter 
Local variable 
Local variable 



FIB PSHS A, U, CC 

LEAU 4,S 
LEAS -4,S 

* 

LDA FPARl, U 
BLE ERR1 
CMPA #1 
BNE FIB2 
LDD #0 
BRA EXIT 

FIB2 CMPA #2 

BNE FIBN 
LDD #1 
BRA EXIT 

FIBN LEAS -2,S 

DECA 

PSHS A 
* 

BSR FIB 
LEAS 1,S 
* 

PULS D 

STD FIBL1,U 



; Save registers 
; Set stack frame register 
; Space for local variables 
FIBL1 and FIBL2 

Get input parameter 

If it is not positive, error 

is it 1st Fibonacci number? 

If not, try the second 

D = FIB(l) 

Get out of routine 

Is FIB (2) required 

No, compute FIB(n) 

D = FIB (2) 

Get out 

Get stack space for result 

FIB(N-l) is being computed 

Parameter for recursive call 
of FIB 

Call FIB 
; Discard parameter 
S now refers to result 
; Pull result into D 

Store D into local variable 



* Now call Fib again to compute FIB (N-2) 



DECA 

LEAS -2,S 
PSHS A 
BSR FIB 
LEAS 1,S 
PULS A,B 
STD FIBL2, U 



A = N - 2 

space for result 

stack parameter 

and call FIB recursively 

discard parameter 

D = FIB (N-2) 

Assign to local 
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* Now add locals to get Fibonacci number 
* 





LDD FIBL2,U 




ADDD FIBL1,U / D = FIB(N-l) +FIB(N-2) 




BRA EXIT ; get out 


ERR1 


LDD #-1 ; D = -1 if error 


EXIT 


STD FRES1,U ; Store D in result space 



PULS A, U, CC, PC ; Restore and return 

Program 6.4 FIB - compute nth Fibonacci number 

This routine can be optimised by using the space on the 
stack reserved for the result of FIB as local working 
store and by removing some redundant load instructions. 
We leave this optimisation as an exercise for the 
reader . 

You will probably have to think quite hard to 
understand exactly what the FIB program is doing. You 
may find it helpful to draw a diagram of the stack 
structure and see how it expands and contracts as the 
routine is called recursively. Whilst this example 
demonstrates the power of assembly language, it also 
shows that, if you try to do complex things, the code 
to implement them can be difficult to understand! 

The generalised parameter passing and local variable 
allocation techniques which we have described are 
useful when you are writing large programs with many 
subroutines or when you are building a subroutine 
library. For fairly small assembly language programs 
their generality can be confusing and it is better to 
adopt a simpler parameter passing technique. 

However, we do recommend that you should avoid the 
allocation of fixed local variable space for 
subroutines. In many cases, you can use registers as 
local work areas and this is often the most efficient 
approach. In other cases, where this is impossible, 
you should use the stack as a local work area. You may 
either set up the U register as a pointer to this area 
or may use S register relative addressing to access 
local subroutine variables. These techniques are 
illustrated in some of the character string 
manipulation routines which are described later in this 
chapter . 

6.2 CHARACTER STRINGS 

We have described how BASIC arrays can be set up using 
the FCB, FDB, and RMB directives. These arrays can be 
accessed using index registers with the array length 
held in an accumulator register. Naturally, these 
arrays can be arrays of characters and this is one way 
of carrying out character manipulation in assembly 
language . 

However, the use of fixed-length arrays to hold 
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character strings means that the decision as to the 
number of characters in a string must be made when the 
array holding the string is declared. In this respect, 
character arrays are not like BASIC 'S character strings 
where the number of characters in a string may vary 
from to 255. When this flexibility is required, it 
is not usual to implement character strings as fixed- 
length arrays. 

In this section we describe how the assembly 
language programmer may set up variable-length 
character strings and we explain how various string 
manipulation operations can be implemented. In section 
6.3 we provide listings of a package of subroutines 
which implement character string operations. 

In order to implement variable-length strings the 
programmer must set aside a large data area for string 
storage where the actual characters making up the 
string are kept . The string name is associated with a 
2-byte area which holds the address of the string 
characters within the string storage area. 

The fundamental operations which are normally 
allowed on character strings are as follows: 

(1) Comparison 

Character strings are compared for equality 

(2) Assignment 

One character string is assigned to another 

(3) Catenation 

Two character strings are put together (catenat- 
ed) to form a longer string 

(4) Substring selection 

Part of a character string (a substring) is 
selected 

(5) Length computation 

The number of characters making up a string is 
computed 

There are also other operations which may be carried 
out with character string operands such as determining 
the ASCII value of a particular character and 
converting numeric strings to integers and vice-versa. 

Given that all character strings are to be stored in 
a common string storage area, the first decision that 
the programmer must make is how to represent strings so 
that the length of the string can be determined. All of 
the string operations listed above need to know the 
string length in order to operate correctly. 

Probably the simplest variable-length string 

representation technique is to associate an explicit 

' end-of -string ' character with each string. This 
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character is catenated with the characters making up 
the string so that the storage space required for the 
string is the length of the string plus one byte. 
Usually the null byte, hexadecimal 00, is used as the 
string terminator. Therefore the string 'HI THERE' 
would be stored as 'HI THERE<NULL> ' . 

There are two advantages of using this technique of 
variable-length string representation . 

(1) There is no limit to the length of the strings 
which may be represented. 

(2) Strings whose length cannot be predicted can be 
stored in this way as the string 
modification (adding the null byte) is carried 
out after the entire string is known. This means 
that the technique is very useful for represent- 
ing strings which are input from the keyboard or 
some other device. Obviously, the length of such 
strings is not known in advance. 

The disadvantage of this representation technique is 
that string length determination requires a program to 
explicitly count the string characters until a null 
byte is detected. This takes time and when a program 
does a lot of character manipulation, this time penalty 
may be unacceptable. 

An alternative technique for string representation 
is to hold the length of the string as the very first 
byte of the string. For example, the string 'HI THERE ' 
would be stored as <8>HI THERE. This means length 
computation is very fast but has the disadvantages that 
the maximum string length is 255 characters and that 
the length of the string must be known in advance 
before it can be entered in the string store. 

As character strings are represented as a 2-byte 
reference to the string store, the assignment of one 
character string to another is a very efficient 
operation. There is no copying of the string 

characters themselves. Assignment simply involves 
assigning one string reference to another. However, 
this can result in much wasted store. The reason for 
this is best illustrated by an example. 

Assume that the variables STR1, STR2, and STR3 have 
been set up using an FDB directive and have been 
initialised to refer to strings as follows: 

STR1 -> 'HI THERE' 
STR2 -> 'WELCOME' 
STR3 -> 'HELLO' 

If STR1 is assigned to STR2, this means that STR2 now 

points to the string 'HI THERE ' and the string 

'WELCOME' is no longer referenced by anything. However, 
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the space occupied in the character store by this 
string cannot magically disappear so, if many string 
assignments are executed, the string store soon fills 
up with such inaccessible 'garbage ' . 

This is a general problem which is inherent in all 
systems where variable-length strings are allowed. The 
BASIC programmer has the advantage that the BASIC 
system has an in-built 'garbage collection ' routine 
which finds all unreferenced strings in its string 
store and marks the store which they occupy as 
reusable. Garbage collection is a fairly complex 
operation and the interested reader should refer to a 
computer science textbook which covers data structures 
for a description of various garbage collection 
algorithms . 

Rather than discuss garbage collection, we describe 
how routines can be written to allocate and deallocate 
space in the string storage area so that the amount of 
garbage is minimised. The first routine described 
below is called GETSP. This takes one parameter, say 
n, and returns an address in the string storage area of 
n consecutive unused bytes. The second routine below 
is FREESP, which is called after string assignment, to 
mark a group of bytes as being available for re- 
allocation . 

Let us assume that the string storage area is called 
HEAP and is set up using the following directive: 

HEAP RMB 4096 ; String storage area 



Furthermore, let us assume that we use an explicit 
length byte at the start of each string. If this byte 
has a value between and 254, this is taken as the 
string length. If the length byte is 255, the 
following two bytes hold a number which is the number 
of unused bytes in that area and therefore available 
for string allocation. 

Figure 6.3 shows part of HEAP with intermingled 
character strings and free space. Initially, HEAP is 
set up so that the very first byte (byte 0) is 255 and 
bytes 1 and 2 hold the 16-bit integer 4096 indicating 
that the entire storage area is available for 
allocation. The routine GETSP starts at the beginning 
of HEAP searching for a byte whose value is 255. When 
such a byte is found, GETSP checks if the number of 
free bytes available is enough to satisfy its request. 

If so, GETSP claims what it needs from this free 
space and marks the remainder as free. If the free 
space is not sufficient, GETSP goes on to find the next 
byte whose value is 255. If no free space is found 
before the end of the string storage area, GETSP 
returns an error indicator showing that it is unable to 
satisfy the request for space. 
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Fig. 6.3 String storage area organisation 



The code for the routines GETSP and FREESP is provided 
in section 6.3. For the moment, let us assume that they 
are available and have the following specifications: 

* GETSP - gets space on heap 
* 

* Register input B - number of bytes required 

* Register outputs Y - pointer to space requested 

* CC.V = if no space available 

* CC.V = 1 if request satisfied 



* FREESP - returns free space to heap 

* Register input X - address of space to be freed 

* Register output CC.V = if invalid address 

* CC.V = 1 if space freed 

Given these routines, the initialisation of strings can 
be implemented as shown below. Assume that a string, 
terminated by a null byte, has been read into an input 
buffer area called INBUF. The routine STINIT takes the 
address of INBUF as its parameter in register X and 
returns in register Y the address of the initialised 
string on the heap. The assembly code for this routine 
is: 



* STINIT - Initialise a string 
* 

* Register input X - input buffer address 

* Register outputs Y - string address in heap 

* CC.V = if error 

* CC.V = 1 if no errors 
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STINIT 



* 
* 



STCNT 



FSPCE 



XIT 



PSHS X,A,B,PC 
CLRB 



TFR X, Y 

LDA , Y+ 

BEQ FSPCE 

INCB 

BRA STCNT 

INCB 

BSR GETSP 

BVC XIT 

DECB 

STB , Y+ 

BSR CPSTR 

ORCC #2 

LEAY -1, Y 

PULS X,A,B 



; Restore and return 

; B is counter 

holding length of string to be 

initialised 

; Save value of X 

; Get string byte 

; If null byte, stop count 

; Otherwise, count it 

; To account for length byte 

; get space 

; No space found - error 

; No of characters in string 

; Store length 

; String copy -see examples 

; Set success flag 

; To point at length byte 

; Restore and return 



Program 6.5 STINIT - string initialisation 

Further examples illustrating string manipulation 
techniques are provided in the following section. 



6.3 



STRING MANIPULATION ROUTINES 



This section is entirely taken up with listings of 
routines which carry out string manipulation. All the 
examples here are written in a position-independent way 
and may readily be incorporated with your own programs. 

* CHKHP - check string validity 

* Register input X - string address 

* Register output CC. V = 1 if string in heap 

* CC.V = if not in heap 

* 

; Save register 

; Heap start 

; comparison 

; Input address <• heap start 

; Heap end 

; comparison 

; Input address > heap end 

; Set CC.V 

; CC.V = 

; Restore and return 

Program 6. 6 CHKHP - check string address validity 

* CPSTR - copy string characters 

* Register inputs X - source string address 



CHKHP 


PSHS X 




LEAX HEAP, PCR 




CMPX ,S 




BHI HPERR 




LEAX HEAPEND,X 




CMPX ,S 




BLO HPERR 




ORCC #2 




BRA XI Tl 


HPERR 


ANDCC #$FD 


XIT1 


PULS X,PC 
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* 


Y - 


dest 


ination string addr&ss 


* 
* 


B - 


string 


length 


CPSTR 


PSHS X, Y, A, B 




/ 


Save registers 




TSTB 




/ 


Check for zero length 


CPLOOP 


BEQ XIT2 




r 


Check if finished 




LDA ,X+ 




r 


Get character 




STA , Y+ 




r 


and copy it 




DECB 




r 


B is counter 




BRA CPLOOP 








XI T 2 


PULS X, Y, A, B, 


PC 


r 


Restore and return 




Program 6. 7 


CPSTR 


- copy characters 



* GETSP - get space for string 
* 

* Register input B - number of bytes required 

* Register output Y - string address 

* CC.V = if request fails 

* CC.V = 1 if request satisfied 

* Uses first-fit algorithm, ie, returns first area 

* large enough to satisfy request. Returns excess 

* space as free if space found > space requested 



GETSP PSHS A, B, X, U 

TFR S,U 

LEAX HEAPEND,PCR 

CLRA 

PSHS X,A,B 

LEAY HEAP,PCR 
FFREE CMPY -2, U 

BHS NTFND 

LDA ,Y 

CMPA #255 

BEQ SPFND 

LEAY 1,Y 

BRA FFREE 
SPFND LDD 1, Y 

CMPD -4, U 

BHS LENOK 

LEAY 3,Y 

BRA FFREE 

* Now check if too much spa 

* an extra 1 or 2 bytes as 
LENOK LDD -4, U 

ADDD #2 
CMPD 1,Y 
BHS EXITOK 
LDD 1, Y 
SUBD -4,U 
PSHS A,B 
LDB -3, U 
LEAX B,Y 
LDA #255 



Save registers 

U is pointer to locals 

1st local = U-2 

U-4 is 16-bit length 

Locals onto stack 

Initialise to heap start 

At heapend? 

Yes, no space available 

Check if free area 

by comparing with 255 

If so, space found 

Otherwise increment Y 

and keep looking 

Pick up free area length 

Compare with length needed 

We have enough 

No, look for next free 

area on heap 
ce . Don't return 
they are unusable 
; Space requested 
; If D + 2 >= that available 
; don't return space 
; and exit 

; get space available 
; subtract space requested 
; and save on stack 
; B = 8 bit length 
; start of free string 
; Free indicator 
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STA ,X+ 


r 


and mark byte free 




PULS A,B 


r 


get free string length 




STD ,X 


r 


and store it 




BRA EXITOK 


r 


and exit 


NTFND 


ANDCC #$FD 
BRA XIT3 


f 


Error indicator 


EXITOK 


ORCC #2 


* 


No errors 


XIT3 


LEAS -4,S 


r 


Discard local space 




PULS A, B, X, U, PC 


r 


Restore and return 



Program 6.8 GETSP - get string space 
* FREESP - free space on heap 



* Regist 

* Regist 
* 
* 

FREESP 



er input X - address of space to be freed 

er output CC.V = 1 if space freed 

CC.V = if invalid input 



LKLAST 
FLOOP 



CHKJN 



XIT7 

EEXIT 
END 7 

* 



PSHS A, B, X, Y 

BSR CHKHP 

BVC EEXIT 

LDB ,X 

INCB 

LDA #255 

STA ,X 

CLRA 

STD 1,X 

LDA #255 

CMPA B,X 

BNE LKLAST 

LEAY B,X 

BSR JOIN 

TFR X, Y 

CMPA , -X 

BEQ CHKJN 

BSR CHKHP 

BVC XIT7 

BRA FLOOP 

LDD 1,X 

STD , — S 

TFR X,D 

ADDD , S++ 

PSHS Y 

CMPD , S++ 

BNE XIT7 

BSR JOIN 

ORCC #2 

BRA END 7 

ANDCC #$FD 

PULS A, B, X, Y, PC 



Save registers 

Is input valid? 

No, error return 

String length 

To get actual no of bytes 

Free space indicator 

Mark string free 

and store 16-bit 

free string length 

See if following string 

is free 

No, try preceding string 

yes, so join strings 

Find preceding free string 

Is byte free 

Yes, can it be joined 

At heap start? 

No preceding free string 

Length of free string 
Stack it 

D = address+length 

Are strings adjacent 
No, return 
Yes, join them 
Set CC.V 

Clear CC.V 



* JOIN - join adjacent free segments 

* Register inputs X, Y - addresses of areas to be 

* freed 
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JOIN 



PSHS 


A,B 




LDD 


1,X 




ADDD 


' i,y 




STD 


1,X 




CLR 


,Y 




CLR 


1,Y 




CLR 


2,Y 




PULS 


■ A,B, 


PC 



Length of 1st area 
Length of 2nd area 
Store total 
Get rid of free indicators 



Program 6.9 FREESP - free string space 

* CMPSTR - compare strings for equality 

* Register input X - string 1 

* Y - string 2 

* Register output CC.Z = 1 if strings equal 

* * CC.Z = if not equal 



CMPSTR 



CMPLP 



CMPXIT 



PSHS A,B,X r Y 

IDA ,X+ 

CMP A ,Y+ 

BNE CMPXIT 

TSTA 

BEQ CMPXIT 

LDB r X+ 

CMPB ,Y+ 

BNE CMPXIT 

DECA 

BRA CMPLP 

PULS X,Y,A,B,PC 



Save registers 

Length of string 1 

must be same as length 2 

If not, exit, CC.Z=0 

Check for length 

A = 0, so all done, CC.Z=1 

Get character 

and compare 

Not the same, CC.Z=0 

Yes, decrement length 

and continue comparisons 

Restore and return 



Program 6.10 CMPSTR - compare strings 



* STRCAT - catenate strings 
* 

* Register inputs X - string 1 

* Y - string 2 

* Register outputs Y - new string 

* CC.V = 1 - no errors 

* CC.V = - error 
* 



STRCAT 



PSHS X,A,B 
BSR CHKHP 
BVC XIT8 
EXG X,Y 
BSR CHKHP 
BVC XIT8 
LDB ,Y 
ADDB ,X 
BVS EEXIT 
CMPB #255 
BEQ EEXIT 
STX , — S 

STY ,—S 
INCB 



Check 1st string 
Invalid, abort 

Check 2nd string 

Invalid, abort 

work out length 

of new string 

Too long (overflow) , abort 

255 also too long 

Stack string addresses 

Total space needed incl. 
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EEXIT 
XI T 8 



BSR GETSP 
BVC XIT8 
DECB 
STB , Y+ 
LDX , S++ 
LDB ,X+ 
BSR CPSTR 
LEAX -1,X 
BSR FREESP 
LEAY B, Y 
LDX , S++ 
LDB ,X+ 
BSR CPSTR 
LEAX -1,X 
BSR FREESP 
ORCC #2 
BRA XIT8 
ANDCC #$FD 
PULS A,B,X,PC 



length byte. Get space 
No space, abort 
New string length 
stored as 1st byte 
Get source address 
and its length 
and copy characters 
Then free space 

Update destination 
Get source address 
and its length 
and copy characters 
Then free space 

Set CC.V 

Error indicator 



Program 6. 11 STRCAT - catenate strings 



* SUBSTR - select substring 
* 

* Register inputs X - source string address 

* A - substring length 

* B - offset from string start 

* Register outputs Y - new address or error number 

* CC.V = 1 - no errors 

* CC.V = - error 
* 



SUBSTR 



STROK 



INDXOK 



LENOK 



PSHS X,A,B 
BSR CHKHP 
BVS STROK 
LDY #0 
BRA EEXIT1 
INCB 

LEAY B,X 
PSHS Y 
LDB ,X 
INCB 

LEAY B,X 
CMPY ,S 
BLS INDXOK 
LDY #1 
BRA EEXIT1 
LDU ,S 
LEAU A, U 
PSHS U 
CMPY , S++ 
BLS LENOK 
LDY #2 
BRA EEXIT1 
INCA 



Save registers 

Is string valid? 

yes, next check 

error type indicator 

error exit 

To get offset from 1st char. 

Substring address 

Stack it 

Total string length 

To account for length byte 

End of string address 

With substring address 

If invalid index 

Index error = 1 

Substring address 

Add length 

and stack it 

Compare with end of string 

is index + length valid? 

No, length too long 

To get number of bytes for 
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TFR A,B 




BSR GETSP 




BVS GSPOK 




LDY #3 




BRA EEXIT1 


GSPOK 


PULS X 




DECB 




STB ,Y+ 




BSR CPSTR 




ORCC #2 




BRA XIT5 


EEXIT1 


ANDCC #$FD 


XIT5 


PULS X,A,B,PC 



get space parameter 
Get the space 

No space available error 

Source address 
For string length 
New string length 
Now copy characters 
No errors 

Indicate error 
Restore and return 



Program 6.12 SUBSTR - select substring 

6.4 POSITION-INDEPENDENT CODE 

One of the problems which can arise when you try to use 
machine code routines which have been written by other 
people is that these routines make assumptions about 
the contents of particular memory locations which you 
have used for other things. What has happened is that 
the operation of the routines depends on particular 
instructions and/or data residing at fixed addresses 
and, if these instructions /data are not at these 
addresses, the routines will not work. 

Routines like this are called 'position dependent ' 
and often cause many problems for the assembly language 
programmer. However, it is possible to write 'position 
independent ' code which executes correctly irrespective 
of where it is loaded into the machine memory. If you 
are building a library of subroutines or writing a 
program which may run on other machines, you should 
always write position-independent code. 

Position-independent code (PIC) is code that 
executes in the same way regardless of where it resides 
in memory. In other words, if it is located at a 
different address from that which it was originally 
assembled, it will still execute correctly. To produce 
position-independent code for the Dragon, you must 
adhere to a single fundamental rule: 

All addresses which you use in your program should 
be relative rather than absolute addresses. 

In general, it is best to write your routines so that 
addresses are all relative to PC but it is also 
possible to use the direct addressing mode of the M6809 
in the production of PIC. For the meantime, however, 
we shall concentrate on how to produce PIC by using 
PC-relative addressing. 

We have already seen examples of PC-relative 
addresses as all the M6809 branch instructions refer to 
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the destination address as an offset from the current 
value of the program counter. Therefore, even if the 
code is moved (relocated) to some other address, the 
relative distance between the branch instruction and 
its destination remains the same. However, you cannot 
cheat by adding or removing machine code instructions 
without re-assembly . If you do so, the program will not 
work as the relative distance specified in the branch 
instruction will be incorrect. 

In early microprocessors, the production of PIC was 
often difficult because relative branch instructions 
only allowed an 8-bit offset thus restricting the 
relative branch to the range -128 -> 127. However, no 
such problem exists in the M68C9 as long branch 
instructions allowing offsets from 32161 to -32168 may 
be used. In fact, if you wish to use some of the 
examples discussed in earlier chapters in combination 
with the examples in this chapter, you may have to 
change some of the BSR instructions to LBSR 
instructions as the subroutine code may be located more 
than 121 bytes away from the subroutine call . 

As well as addressing instructions in a position- 
independent way, it is also essential that data are 
also addressed using the PC-relative addressing mode. 
Although we introduced this addressing mode in Chapter 
2, our examples so far have mostly used direct, 
extended or indexed addressing. The reason for this is 
that we felt that the introduction of PC-relative 
addressing was peripheral to the concepts illustrated 
in the examples. 

Recall that the M6809 's PC-relative addressing mode 
uses the program counter as an index register and adds 
either an 8-bit or a 16-bit offset to it. The table 
below shows examples of how data can be addressed in a 
position-independent way using PC-relative addressing. 
Assume that TABLE, WORD, and DATA are storage locations 
set up using an FCB or RMB assembler directive. 

Non-PIC PIC 

LDX STABLE LEAX TABLE, PCR 

LDX WORD LDX WORD, PCR 

STA DATA STA DATA, PCR 

Notice how easy it is to write code in a position- 
independent way. Instead of referring to the absolute 
symbolic address, all you have to do is to tell the 
assembler that PC-relative addressing is to be used. 
The assembler works out the correct displacement from 
the instruction position and generates the appropriate 
postbyte and offset. 

The only instructions which cause any real 
difficulty are those which use 16-bit immediate 
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addressing where the 16-bit value in the instruction 
refers to an absolute address. To load such addresses 
in a position-independent way, the LEA instruction 
rather than the ID instruction is used. Therefore, 
rather than saying LDX STABLE to load the address of 
TABLE into register X, this should be written LEAX 
TABLE, PCR. 

However, other instructions such as CMP which might 
also use immediate values which are addresses do not 
have position-independent forms. This means that when 
a 16-bit register is to be compared with an immediate 
value representing an address, we have to make use of a 
temporary location on the stack. 

For example, consider the following fragment of 
non-PIC code which is often found in programs which 
look up tables of values. 



LOOP 



LDX #TABLE ; Set up base address of table 

Code to look 

up table 

CMPX #TABEND ; is table completely scanned 

BNE LOOP 

TABLE FCB «table data values) 

TABEND EQU * ; table end 

In this example, TABLE and TABEND represent absolute 
addresses and, if relocated without reassembly, this 
code would not execute properly. In order to make this 
code position independent, we must ensure that all 
absolute addresses are eliminated. We do this by using 
the LEA instruction to compute an address and we then 
store this address where it may be accessed and 
compared. We need a temporary location for the 
absolute address and, as always, the best place to 
allocate temporary store is on the stack. 

We might, therefore, write the above example in a 
position independent way as follows. 

LEAX TABEND, PCR 

PSHS X ; Stacks address of TABEND 



LEAX TABLE, PCR 



LOOP 



CMPX ,S ; Compare X with top stack 

BNE LOOP 

LEAS 2,S ; Discard top stack element 

In general, when you are writing your own routines you 
should always try and use PC-relative addressing so 
that PIC is generated by the assembler. However, if 
you are making use of routines built into the BASIC 
system, such as the input and output routines INCH and 
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OUTCH described in Chapter 5, PC-relative addressing 
should not be used. 

The reason for this is that these routines always 
reside at fixed locations and if you relocate your own 
program, the system routines do not move with your 
program. Therefore, you should always use jump rather 
than branch instructions to reference these system 
routines . 

For example, to reference the input routine at 
address 8006, you might write the following code: 

INPUT EQU $8006 



JSR INPUT 

It would be quite incorrect to say LBSR INPUT as 
relocating your code would cause the displacement built 
into the branch instruction to be incorrect. 
Naturally, the same applies to memory areas which have 
a dedicated function, such as the BASIC screen area. 
This starts at absolute address 400, so ID rather than 
LEA instructions are used to pick up that address. 

6.4.1 Jump tables 

The only real problem associated with PIC arises when 
some other program is assembled and uses PIC routines. 
Naturally, the addresses of these routines are 
assembled into the program and, if the routines are 
relocated, these addresses will be wrong. After 
relocation, it is necessary to modify the program to 
reflect the new, relocated addresses and this seems to 
negate some of the advantages of producing PIC. 

In order to avoid a great deal of tedious address 
modification, an addressing technique can be used which 
isolates the necessary changes so that only a single 
table need be changed. This technique is based around 
the idea of so-called 'jump tables ' or 'vector 
locations ' . 

A jump table contains, at known positions, a link to 
the actual addresses of routines and data used by a 
program. If these addresses change, only the jump 
table need be modified to reflect the new addresses. 
There is no need to change the program which refers to 
these addresses through the jump table. 

Where routines are addressed, the jump table is 
usually made up of jump or branch instructions (hence 
the name) which immediately jump to the addressed 
routines. We shall see shortly how such a table, which 
is called a direct jump table, may be set up. 

When data are referenced via a jump table, the table 
locations do not contain instructions but merely hold 
the address of the referenced data. The data item can 
be accessed using indirect addressing. Hence, this 
type of jump table is often termed an indirect jump 
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table. Of course, there Is no reason why the data In 
such a table should not be subroutine addresses. The 
actual routines would then be called using a JSR 
Instruction with the Indirect addressing mode. 

Jump tables are the mechanism which provides access 
to the BASIC I/O routines. In fact, there are two jump 
tables referencing these routines - a direct jump table 
starting at address 8000 and an Indirect jump table 
starting at address AOOO. 

As an example of how these tables can be used, 
consider the character Input routine discussed In 
Chapter 5. In the direct jump table, address 8006 
holds a jump to this routine whereas the first location 
In the Indirect jump table (AOOO) Is set up with the 
address of the Input routine. 

If we wish to use the direct jump table, the 
following Instruction Is used to call this Input 
routine : 

JSR $8006 

On the other hand, If the Indirect jump table Is used, 
Indirect addressing must be used to reference the Input 
routine : 

JSR ($A000) 

The jump tables for these BASIC I/O routines are set up 
at known locations but If you envisage that other 
programs will use your routines, It Is a 
straightforward matter to set up your own jump tables. 

The skeleton example below shown how direct and 
indirect jump tables may be defined by the assembly 
code programmer. 

SUB1 

<code for subroutine 1> 
SUB2 

<code for subroutine 2> 

SUB3 

<code for subroutine 3> 
* 

* Now set up an origin for the jump table 
* 

ORG $1000 
SUB1V JMP SUB1 

SUB2V JMP SUB2 

SUB3V JMP SUB3 

* 

* If an Indirect jump table Is required It 

* might be set up as follows: 

SUB1V FDB SUB1 

SUB2V FDB SUB2 



147 



SUB3V 



FDB SUB3 



This is a simple way to set up jump tables but the 
disadvantage with this technique Is that the addresses 
filled In the jump table are those known when the 
program Is assembled. They are called 'static 

addresses ' . If the program is relocated, these 
addresses remain as they were and are therefore 
incorrect . What is needed is a technique which 
allocates addresses to a jump table immediately before 
the program runs. That is, the jump table must be set 
up dynamically each time the program is executed. 

To calculate the addresses at run-time requires the 
use of initialisation code which fills in the jump 
table addresses. The following initialisation code 
shows how this can be achieved. 



INIT 
* 



LEAX SUB1,PCR 
STX SUB1V+1 

LEAX SUB2,PCR 
STX SUB2V+1 
LEAX SUB3,PCR 
STX SUB3V+1 



; SUB1V+1 because the 
JMP opcode is at SUB1V 



SUB1V 
SUB2V 
SUB3V 



ORG $1000 

JMP $0000 

JMP $0000 

JMP $0000 



; Jump table address 



We leave it as an exercise for the reader to work out 
how to initialise an indirect jump table dynamically. 

Normally, the INIT routine is the very first routine 
in a program as it is essential that its address is 
known in order that it may be called to set up the jump 
table. Placing INIT at this position also means that 
the program can be initiated from BASIC once CLOADMed 
by using the EXEC command. There is no need to specify 
an address for EXEC. 

The use of an initialisation routine opens up the 
possibility of using an alternative technique of 
producing position-independent code. This technique 
relies on all addresses being direct addresses with the 
actual address computed by adding the contents of DP to 
the address specified in the instruction. In other 
words, the instruction address is actually a DP- 
relative address. 

In order to produce PIC code using direct 
addressing, DP must be set up dynamically at the start 
of program execution. The INIT routine must search for 
an available page in memory and assign its address to 
the direct page register. You might wish to explore 
the possibilities of this technique but be warned that 
the BASIC system keeps many pages for its own use and 
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assumes that they will not be used by the programmer. 
You have to be very careful about saving and restoring 
the value of the DP register and it is our opinion that 
the use of PC-relative addressing is a better way of 
producing position-independent code. 

6.5 COMBINING ASSEMBLY LANGUAGE WITH BASIC 

A disadvantage of assembly language programming is that 
it is difficult to write and test low-level language 
programs even when strict rules of programming are 
adhered to. This is in contrast to BASIC programs 
which, because of the way in which BASIC is 
implemented, are easy to test. It is simple to print 
out the values of variables as the program executes or 
to break in and inspect variable values that you think 
might be wrong. Ideally, we would like this flexibility 
but with the speed and power of assembly language. 

There is no such ideal system but, in many cases, it 
is possible to call assembly code routines from BASIC 
programs thus using high and low level programming in 
the most productive way. It is a fact that most 
programs spend most of their time executing a 
relatively small proportion of the total program code. 
The speed of BASIC programs can be significantly 
increased by identifying execution-intensive sections 
and replacing these by machine code equivalents . In 
this way, the majority of the program made up of user 
prompts, print statements, etc. can remain in BASIC 
with only time critical sections programmed in assembly 
language . 

The easiest way to incorporate machine code routines 
in a BASIC program is to use BASIC'S EXEC statement. 
The EXEC statement takes an address as a parameter and 
transfers control to the code residing at that address. 
It is used as follows: 

EXEC <address> 

In actual fact, the address operand, which must lie in 
the range 0000 to FFFF, in the EXEC statement is 
optional. If it is present, the machine code routine at 
that address is executed with control returned to BASIC 
after a RTS or PULS PC instruction is executed. If the 
address is omitted, EXEC consults a jump table (the 
EXEC vector) to find the address of the code to be 
executed. 

The EXEC vector is located at address 9D and is made 
up of a single word only. Therefore, the memory 
locations 9D and 9E should contain the address of the 
code to be EXECed. Initially, the EXEC vector is set 
up to contain the address of an error routine which 
explains why the message ' ?FC ERROR' is output when an 
EXEC without a parameter is used as the first EXEC in a 
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program. If an address is specified in an EXEC call, 
that address is filled into the EXEC vector with the 
result that subsequent EXECs without an address 
parameter call the machine code at that address. 

An alternative way to set up the EXEC vector is via 
the CLOADM command. 

CLOADM "Name" 
EXEC 

This instruction sequence sets up the EXEC vector to 
refer to the execution address of the machine code 
program called "Name" which has just been loaded. The 
EXEC instruction then transfers control to this code. 

The main advantage of EXEC is its simplicity and the 
fact that it can be used to invoke any number of 
machine code routines. The main disadvantage with EXEC 
is that any routine parameters must be passed in memory 
locations and the programmer must POKE these parameters 
into known locations before the EXEC call . Similarly, 
the results of executing the machine code routine must 
be in known locations and can only be retrieved using 
PEEK. 

An alternative way to invoke machine code routines, 
which permits parameter passing, is to make use of the 
USR call. The number of USR calls available to the 
BASIC/machine code programmer is restricted to ten and 
these are named USRO to USR9. USR calls do not take an 
explicit address but transfer control to the address 
which the programmer has previously associated with 
that USR call. 

The addresses to which particular USR calls should 
transfer control are set up using a DEF USR statement. 
This has the general form: 

DEF USRn = address 

The number n must be a single digit in the range to 9 
and the address must lie in the range to FFFF. The 
general form of the USR call itself is: 

USRn (<argument>) 

Executing a call of USRn causes control to be 
transferred to the address specified in the 
corresponding DEF USRn statement . Although the 
definition of the USR call function states that the 
name USR should be followed by a single digit from to 
9, readers who try to call USR in this way will find 
that all USR calls actually result in a call to USRO. 
This is due to an error in the BASIC system which, 
fortunately, can be circumvented very easily. 

The bug in the BASIC system causes the interpreter 
to skip the digit so that USRO is taken to be the same 
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as USR1, USR2, etc. As BASIC takes a USR call without 
a parameter to be equivalent to USRO, the effect of the 
bug Is to make all USR calls default to USRO. 

Rather than call a USR call as USR1, USR6, USR9, 
etc . , the digit Indicating which USR call Is to be used 
should be padded with an extra zero. Therefore, to 
call USR1, you must actually write USR01, to call USR6, 
you must write USR06, etc. Obviously, this is not 
necessary for USRO but for reasons of consistency it is 
probably better to call this as USR00. 

A USR call from BASIC is treated like a BASIC 
function so that it is used as part of an expression 
and should return a value to the BASIC program. 
Examples of USR calls are: 

10 DEF USRO = SH1000 : DEF USR1 = SH2000 

20 A = USROO(A) : ' Transfers control to &H1000 

30 IF USR01 (0) = THEN B = B + 1 

If a USR call is used without first defining the 
address it refer to, the USR call will cause a message 
'?FC ERROR' to be printed. Like the EXEC statement, 
each USR call has an associated vector which contains 
the address of the entry point of the machine code 
routine to be executed. The USR vector is initially set 
up to refer to the error routine which prints the '?FC 
ERROR' message. When a DEF USR statement is used, this 
fills in the address in the appropriate vector. 

The table below lists the vector addresses 
associated with each USR call. 



USR Call 


USR Vector 


USRO 


134:135 


USR1 


136:137 


USR2 


138:139 


USR3 


13A-.13B 


USR 4 


13C:13D 


USR5 


13E-.13F 


USR 6 


140:141 


USR7 


142:143 


USR 8 


144:145 


USR9 


146:147 



If you are trying to link machine code and BASIC for 
the first time, we recommend that you experiment with 
the technique by using EXEC rather than USR calls. 
Unfortunately, to set up USR call parameters requires 
knowledge of how BASIC represents numbers and strings. 
We therefore return to the use of USR calls in Chapter 
9 after BASIC'S data representation has been described. 



Chapter 7 

Graphics programming 



One of the greatest advantages of assembly code 
programming, its total flexibility, is also one of its 
most serious drawbacks as the programmer has to concern 
himself with every detail of the problem. One area in 
particular where this lack of support is very evident 
is in graphics and animation. 

The problem becomes very obvious if the would-be 
animator has relied on the graphics facilities provided 
in Extended Color BASIC and has come to expect such 
facilities when designing and writing graphics 
programs. However, the major disadvantage of BASIC 
programming is its inherent slowness and it is in 
graphics applications that this is most evident . Only 
the simplest of games, for example, with minimal 
movement can be programmed in BASIC if they are to 
present a challenge to the player. 

A very large part of the Dragon ' s BASIC system is 
dedicated to providing graphics facilities and it is 
not an easy task to duplicate those features as 
assembly code routines. Nevertheless, if speed is 
required, some graphics programming must be carried out 
in assembly code but the programmer should, as far as 
possible, make use of BASIC for those parts of his 
program which are not time critical. 

In general, a good graphics programming strategy is 
to develop the complete program using BASIC'S 
facilities and to iron out program bugs at this stage. 
This will probably result in a system which is far too 
slow but you may then replace BASIC routines . with 
assembly code routines to speed up your system. 

It is seldom necessary to duplicate the BASIC 
routines exactly unless they are components of other 
routines. Rather, it is usually possible to make all 
sorts of simplifications and later in the chapter we 
look at how to design, code and animate screen 
patterns. The chapter also discusses, in some detail, 
the Dragon's graphics hardware and describes the 
different graphics modes available to the programmer. 

Firstly however, we describe in general terms, how 
the Dragon 's display system is organised. As in most 
personal computer systems, the display system on the 
Dragon is memory-mapped. This means that an area of 
memory is scanned 50 or 60 times per second, depending 
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on the local mains frequency, and the contents of that 
area are translated by special hardware to a standard 
TV signal which may be displayed on a domestic 
television set. 

The machine allocates a 512 byte area of memory for 
an alphanumeric display and it is this area which is 
used to display BASIC program text as it is input, and 
program results as they are output . The Dragon ' s 
alphanumeric display is organised as 16 lines with 32 
characters per line. We show later that this display 
area can also be used as a low-resolution graphics 
area. This text segment is always allocated at address 
400 in memory so locations 400-5FF are dedicated to the 
alphanumeric display. 

The memory dedicated to graphics, that is, the 
display of pictures rather than text, is organised into 
graphics segments of 512 bytes each. In full graphics 
mode, a minimum of 2 segments must be allocated but 
there is no inherent maximum number of graphics 
segments. Obviously, however, the maximum number of 
such segments is limited by the amount of free memory 
available to the graphics programmer. These graphics 
segments are usually allocated from address 600 
onwards, that is, immediately after the BASIC text 
segment. The BASIC system organises these graphics 
segments into 'pages ' of 1536 bytes and a maximum of 8 
pages is available to the BASIC programmer. 

In order to display characters, the display screen 
is considered as a two-dimensional array of 'picture 
elements ' or pixels . The more pixels on the screen, the 
finer detail which can be resolved and the Dragon 
compares favourably with other personal computers in 
this respect. The Dragon's display is made up of 256 
horizontal pixels by 192 vertical pixels. The Dragon's 
graphics hardware provides various graphics modes where 
the screen is considered as a matrix of elements. Each 
element is made up of a single pixel at the highest 
resolution or consists of an array of pixels. 
Depending on the resolution chosen, this array can vary 
from 2 by 1 pixels to 12 by 8 pixels. 

In a memory-mapped graphics system, all information 
about a particular screen element must be encoded in 
memory. This means that the pixel settings and colours 
must be held in memory locations so there is a trade- 
off between display resolution and the number of 
colours available to the programmer. High-resolution, 
multi-colour displays require a great deal of memory to 
encode the screen information so the Dragon ' s graphics 
system limits the number of colours available when 
resolution graphics are used. 

1.1 GRAPHICS DISPLAY HARDWARE 

The Dragon 's graphics display hardware is made up of 3 
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microchips. Working in combination, these chips extract 
information from the system's memory and display that 
information on a standard television screen. The so- 
called 'Video RAM' is the memory area which is devoted 
to the display and the contents of this memory area 
determine what is actually displayed on the user's 
screen . 

The chips making up the graphics system are the 
Video Display generator (VDG - 684 7) , the Synchronous 
Address Multiplexor (SAM - 6883) , and a Peripheral 
Interface Adapter (PIA - 6821) . The interconnections of 
these chips is shown in the system block diagram in 
Figure 1.2. In spite of the fact that the names of 
these chips sounds daunting, it is fairly easy for the 
assembly language programmer to control these devices. 
Each of them, and the Video RAM, is described below. 

7.1.1 The VDG chip 

The video display generator (VDG) chip is the main 
component of the Dragon 's graphics system. As the name 
suggests, it generates the video signals that are input 
to the user ' s television set to provide the screen 
display. For those readers with experience in 

electronics, a complete description of this chip is 
provided in Appendix 3. 

However, you do not need experience in electronics 
to understand how to control this chip. All you must 
understand is that the chip has a set of control lines 
which may be in one of two states representing the 
binary values 1 and 0. When a line represents a 1, we 
say that it is HI, when it represents a binary zero, we 
say that the line is LO. Control signals can be 
generated by writing information to specific memory 
addresses . 

The VDG chip determines the graphics capabilities of 
the Dragon and it does so by providing a selection of 
modes of operation. These modes dictate the resolution 
of the display, the number of display colours, the 
actual colours displayed, etc. In all, there are a 
total of 14 different display modes: 

(1) Four alphanumeric modes 

(2) Two Semigraphics modes 

(3) Four colour graphics modes 

(4) Four resolution graphics modes 

The PMODE statement in BASIC allows some of these modes 
to be provided but not all of them are available to the 
BASIC programmer. However, the assembly language 
programmer may use all of the display modes by directly 
configuring the VDG chip. Each of these modes is 
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described in a separate section later in this chapter. 

The VDG chip has eight control lines which are used 
to select the mode of the display. The table below 
shows the function and the names of each of these 
control lines . 

Control line Function 

A/G Set LO to indicate Alphanumeric 

HI to indicate Graphic mode 

A/S LO to indicate Alphanumeric 

HI , to indicate Semigraphic, mode 
INT/EXT Selects between internal (LO) 

and external (HI) character 

generator ROM. 
GM0,GM1,GM2 Selects the graphics mode 

CSS Selects between the two colour sets 

INV Selects between inverse and normal 

video 

The mode control lines, A/G, INT/EXT, GMO, GM1, GM2, 
and CSS, are connected to the PIA chip as described in 
the following section. The desired mode may be set up 
by setting the appropriate bit pattern in the PIA ' s 
data register. This causes the appropriate control 
signals for the VDG chip to be generated. 

Although six of the VDG control lines are set up via 
the PIA, there are only five output lines from the PIA 
to the VDG chip. There is no need for six lines as the 
INT/EXT and GMO input lines share a single PIA output 
line. When GMO is needed in graphics mode, the value 
of INT/EXT is irrelevant and when the value of INT/EXT 
is actually needed in alphanumeric/ Semigraphics mode, 
the value of GMO is not used. 

The remaining VDG control lines A/S and INV are 
connected to two of the RAM data lines, D6 and Dl . 
These lines can therefore be set on a character by 
character basis in the alphanumeric/semigraphic modes. 

The VDG chip has the capability of generating eight 
colours but, when colour graphics modes are used, 
memory restrictions limit the number of colours which 
may be displayed to four. The eight colours are 
therefore separated into two colour sets and the CSS 
control line on the VDG indicates which colour set is 
in use. 

The colours in each colour set are: 



Colour set 1 


Colour set 2 


Green 


Buff 


Yellow 


Cyan 


Blue 


Magenta 


Red 


Orange 



When the memory bits defining an element are set, this 
means that the element is 'on' and it is displayed in 
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colour. When the associated bits are unset, the 
element Is off and Is displayed as black. 

7.1.2 The peripheral Interface adaptor 

The PIA Is an example of a general-purpose programmable 
Interface device which Is used to Interface the M6809 
processor to other devices. We describe the operation 
of the PIA In Chapter 8 as It plays a very Important 
role In Input/output programming. 

The block diagram of the Dragon In Figure 1.2 shows 
that the system contains two PIA chips. The PIA used to 
control the VDG chip Is PIA1 and, by setting the 
appropriate bits In the PIA ' s B-slde peripheral data 
register, control signals for the VDG chip can be 
generated. 

As the M6809 uses memory-mapped addressing, this 
data register Is set by writing bit patterns to the 
appropriate memory address. PIA1 Is addressed via 
memory locations FF20 through to FF23 with the B-slde 
peripheral data register located at location FF22 . We 
might therefore set up the VDG Inputs as follows: 

IDA <VDG Input state> 
STA $FF22 

In fact, only bits 3 to 7 of this register are used to 
set the VDG control lines with bits to 2 used for 
other purposes by the Dragon. The values of these bits 
are Irrelevant for graphics programming. The table 
below shows the association of bits In the PIA register 
and VDG control lines. 

Bit 3 CSS 

Bit 4 GMO 

Bit 5 GM1 

Bit 6 GM2 

Bit 7 A/G 

7.1.3 The video RAM 

Whilst It Is the VDG chip which determines how data Is 
displayed on the user's screen, It Is the contents of 
the video RAM which specifies what Is displayed. 
Remember that the display Is made up of 256 by 192 
pixels and the contents of the video RAM determine 
which pixels should be displayed and the colour of 
displayed pixels. 

The VDG continually scans the video RAM and uses the 
data there to build up an Image on the screen. 
Therefore, by changing a data byte in the video RAM, 
the programmer can change the pixels In the 
corresponding screen position. The resolution of the 
display Is determined by the number of pixels affected 
when a single data byte of video RAM Is modified. 
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7.1.4 The synchronous address multiplexor - SAM 
The SAM chip has been specifically designed to provide 
the necessary control and timing signals for the M6809, 
the VDG chip, and the video RAM. Much of this 
information is of no relevance to the programmer but 
some aspects of the operation of the SAM chip are 
important . We concentrate on these aspects in this 
section rather than describe the SAM chip in detail . 

Three bits in the SAM control register are used to 
set the appropriate display mode. These bits should be 
set to the same value as bits 3-5 in the VDG control 
register. The SAM control register is memory mapped at 
address FFCO and occupies the address range FFCO to 
FFDF . As the control register is 16 bits wide, why are 
32 bytes allocated in memory to that register? 

The 16-bit control register maps onto the 32-bit 
range FFCO to FFDF so that each register bit is 
represented by two memory bytes which have adjacent 
even and odd values. Therefore bit in the control 
register is represented by FFCO/1, bit 1 by FFC2/3, bit 
2 by FFC4/5 etc. In order to clear a particular bit, a 
write operation to the even address is carried out, and 
to set a SAM control register bit you must write to the 
associated odd address. This technique of setting and 
unsetting the control register bits is the reason why 
32 bytes are allocated to a 16-bit register. 

The SAM control register bits which indicate the 
current graphics mode are the bottom three register 
bits termed VO, VI, and V2 . These have associated 
addresses FFCO/1, FFC2/3 and FFC4/5. To set up the 
graphics mode required, you must carry out the 
requisite write operations to these addresses. 

As well as these mode control bits, there are seven 
other SAM control register bits (bits F0-F6) which are 
used to indicate the base address in memory of the 
graphics segments used for the video RAM. The table 
below shows the association between these SAM control 
register bits and memory bytes: 



FO 


FFC6/7 


Fl 


FFC8/9 


F2 


FFCA/B 


F3 


FFCC/D 


F4 


FFCE/F 


F5 


FFDO/1 


F6 


FFD2/3 



The 7-bit value in the SAM control register is 
multiplied by 512 to compute the base address of the 
graphics segments used. This is the reason why 
graphics segments always have a base address which is a 
multiple of 512 and why they are always 512 bytes long. 
Because the VDG and SAM chips must operate in 
tandem, they are normally set up in the same mode so 



that signal timings, etc. are compatible. If set up In 
different modes, the system will produce garbage except 
when the VDG chip Is In alphanumeric mode and the SAM 
chip Is In one of the colour graphics modes. In this 
case, extra Semlgraphlcs modes are available and these 
are described In section 7.6. 

7.2 INTEGRATING BASIC AND ASSEMBLY CODE GRAPHICS 

One of the strengths of the BASIC system on the Dragon 
Is the graphics facilities provided by Microsoft 's 
Extended Color BASIC. These facilities allow complex 
graphics programs to be written with relative ease but, 
as with all BASIC programs, they are relatively slow. 
Using assembly code speeds up the system's graphics 
very considerably but Is much less convenient for the 
programmer. The Ideal solution Is to use the 

convenience of the BASIC facilities when execution 
speed Is not Important and to program time-critical 
sections of the program In assembly language. 

Typically, those parts of a graphics program which 
are not time critical are the parts Involved with 
Initialisation and hardware setup. In this section we 
look at some useful BASIC graphics commands and 
describe a BASIC subroutine which will set up the 
graphics system then call an assembly language program 
which actually creates the display. 

Of the many BASIC commands used for high resolution 
graphics, three are of particular Importance to the 
assembly language programmer. 

(1) SCREEN type,colourset 

This command Is used to specify whether full 
graphics or alphanumeric/ Semlgraphlcs mode Is to 
be used. For a full graphics mode, type Is 1, 
otherwise 0. The colourset parameter Is either 1 
or and selects the colour set as defined In 
section 7.1.1. 

(2) PMODE mode, startpage 

This statement selects one of the five graphics 
modes available with Extended Color BASIC and Is 
only meaningful If a SCREEN 1, colourset command 
has been Issued. The modes available are summar- 
ised below: 



Mode 


Resolution 


RAM bytes 


Graphics type 





128 by 96 


1536 


Resolution 


1 


128 by 96 


3072 


Colour 


2 


128 by 192 


3072 


Resolution 


3 


128 by 192 


6144 


Colour 


4 


256 by 192 


6144 


Resolution 



The startpage value is used to select the base 
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address of the graphics display. In Extended 
Color BASIC, the display area is made up of one 
to four pages of 1536 bytes each with up to eight 
pages used for the display. Therefore, the start- 
ing page value must lie in the range 1 to 8 with 
page 1 starting at address 600, immediately after 
the text page. The table below shows the rela- 
tionship of pages to RAM addresses . 



Page 


RAM address range 


1 


600-BFF 


2 


C00-11FF 


3 


1200-1 IFF 


4 


1800-1DFF 


5 


1E00-23FF 


6 


2400-29FF 


7 


2A00-2FFF 


8 


3000-35FF 



(3) PCLS c 

This command is used to clear the high-resolution 
display screen to the background colour c, pro- 
vided that c is in the available colour set for 
the current mode. If this is not the case, or c 
is omitted, the default background colour is 
used. This is green if colour set 1 is selected 
and buff if colour set 2 is used. 

SCREEN, PMODE and PCLS are useful to the assembly 
language programmer since they can be used to set up a 
graphics display prior to its use in an assembly 
language program. In other words, the use of these 
commands avoids the need to write machine code routines 
to perform similar functions. 

We show how these can be used in the BASIC 
subroutine below. This routine initialises the 

graphics system using SCREEN, PMODE, and PCLS commands 
then calls an assembly language routine at address 
4E21 . 

1000 SCREEN 1,0 'Select graphics screen 

1010 PMODE 0,1 'Select graphics mode 

1020 PCLS 'Clear graphics display 

1030 EXEC SH4E21 'Call machine code 

1035 ' Don 't return immediately to BASIC 

1036 ' as this means switch to text screen 

1040 IF INKEY$="" THEN 1040 ' and display is lost 

1048 'Switch colour sets and watch 

1049 'screen colours change 

1050 SCREEN 1,1 

1060 IF INKEY$="" THEN 1060 

1070 SCREEN 0,0 'Now revert to text mode 

1080 RETURN 

Program 1.1 BASIC test rig for graphics programs 
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7.3 ALPHANUMERIC DISPLAY MODES 

The alphanumeric mode is the mode adopted by the Dragon 
when it is switched on or reset. In this mode, the 
display is made up of a 32 by 16 matrix of display 
elements with 512 bytes of video RAM dedicated to this 
display. The BASIC system allocates this display area 
at address 400 so that the SAM control register bits 
F0-F6 are set to 02. 

Although the VDG chip supports four different 
alphanumeric modes, the Dragon hardware is only 
designed to make use of one of these. The other modes 
require special read-only memories to be installed and 
attempting to use them will result in unpredictable 
access to RAM. Nevertheless, it is possible to use 
these modes if you are prepared to spend some time in 
experimentation to determine where the VDG accesses 
RAM. The information in the VDG data sheet should be 
sufficient to get you started with these experiments . 

Each character on the display is represented by 8 by 
12 pixels although only 5 by 7 pixels are used to form 
the actual character. The remaining pixels define the 
space between the characters. The shape of the 
characters in alphanumeric mode is determined by a 
read-only memory (ROM) which is build into the VDG 
chip. Unfortunately, this ROM has space for only 64 
characters so this means that the full ASCII character 
set is not available. In particular, lower case 
characters have been excluded and this limits the 
display capabilities of the Dragon. 

As the maximum number of characters which may be 
held in the VDG's ROM is 64, this means that 6 bits of 
an 8-bit byte are required to represent the character 
value. The remaining 2 bits represent the INV and A/S 
control inputs to the VDG chip. One bit specifies 
whether the display mode is alphanumeric or Semigraphic 
and the other specifies whether the character is to be 
displayed in reverse or normal video. The table below 
shows the usage of the bits in an 8-bit data byte: 

Bits 0-5 Character code 
Bit 6 INV control bit 
Bit 7 A/S control bit 

One of the problems which arises with this display mode 
is that there is not a one-to-one correspondence 
between the character code in the video RAM byte (which 
is an ASCII character) and the character which is 
actually displayed. To illustrate this, you might like 
to run the following BASIC program: 

5 CLS 

10 FOR K = to 127 

20 K$ = CHR$(K) 

30 POKE &H400 + K,K 
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40 PRINT @256 + K,K$; 
50 NEXT K 

Program 7.2 Screen character mapping 

The statements at lines 30 and 40 should be equivalent 
in that they should both place the ASCII value of a 
character in the video RAM. However, some characters 
will be displayed differently. 

To further illustrate this point, type in the 
following amendments to the program: 

10 K$=INKEY$: IF K$="" THEN 10 

20 K =ASC(K$) 

50 PI = PEEK(SH400 +K) 

60 P2 = PEEK(SH400 + 256 + K) 

70 PRINT @480, HEX$ (K) , HEX$ (PI) , HEX$ (P2) ; 

80 GOTO 10 

When the program is run, you will see that the actual 
ASCII codes K and PI remain the same but that P2, the 
result of printing a character, is different . This 
means that the BASIC print routine is altering the 
character code before placing it in the video RAM. 

This conversion is carried out by the standard BASIC 
character printing routine OUTCH. We have already 
mentioned this routine in Chapter 5 and, because it 
takes care of the necessary character conversions for 
the VDG chip, we recommend that it always be used for 
character output. 

OUTCH places the character to be output at the 
current cursor position on the screen. The cursor 
position is held in a system variable called CURADR and 
the contents of that variable determines where, on ' the 
screen, the cursor is displayed. Cursor blinking is 
under the control of a system routine called CBLINK and 
the blinking effect is the result of inverting and re- 
inverting the cursor position character. 

As well as performing code conversions, the routine 
OUTCH also carries out other screen 'housekeeping' 
duties. It handles screen scrolling when the end of a 
line is reached, deletes characters from the screen 
when the delete key is pressed, and updates the cursor 
position so that the next character input is at that 
position . 

Normally, the Dragon display consists of dark 
characters on a light background. In fact, the 
'normal ' character set of the VDG chip consists of 
light characters on a dark background so the Dragon 's 
display is actually the inverse character set. This 
means that the INV control bit (bit 6) of each data 
byte must be set to indicate dark-on-light display. To 
illustrate this, the following program manipulates the 
INV bit of every character in the display: 



161 

LDX #$400 ; Display start addr&ss 

NEXTCH LDA ,X ; Character into A 

* INV bit manipulation here - see below 

STA ,X+ ; Put character back 

CMPX #$5FF ; Reached end of screen? 

BLS NEXTCH ; No, repeat 

RTS 

Program 7.3 INV bit manipulation 

The INV bit can be manipulated in the following ways: 

Instruction Effect 

ORA #$40 Sets INV to 1 so 'normalising' the 

display 
ANDA #$BF Clears INV so inverting the display 

EORA #$40 If INV is set, it is unset and vice 
versa . The effect of this is to 
reverse the display 

7.4 COLOUR GRAPHICS DISPLAY MODES 

The VDG provides eight full graphics modes although 
only five of these are directly supported by Extended 
Color BASIC. The modes range from a four-colour 64 by 
64 element display requiring 1024 bytes of video RAM to 
a two-colour 256 by 192 display requiring 6144 bytes of 
video RAM. Four of these modes are termed colour 
graphics modes and these are described in this section. 
Each of these modes is numbered 1, 2, 3 or 6 depending 
on the number of graphics pages required and colour 
graphics modes are indicated by using this number and 
suffixing it with C. 

In any colour graphics mode, the setting of each 
element in the display is controlled by two bits in the 
video RAM byte so that the element may be one of four 
colours. The general format of a video RAM byte for 
colour graphics is shown in Figure 7.1. 



ClC 


CiCo 


CiC 


CiCo 



E3 E2 El EO 

Fig. 7.1 Colour graphics byte format 



Because the VDG is capable of generating eight colours, 
two colour sets each of four colours are available. 
Which colour set is in use is determined by the CSS 
input line to the VDG. The table below shows the 
available colours and their associated coding in the 
video RAM byte. 
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CSS 


Colour 


CI CO 





Green 


00 





Yellow 


01 





Blue 


10 





Red 


11 


1 


Buff 


00 


1 


Cyan 


01 


1 


Magenta 


10 


1 


Orange 


11 



To illustrate each of the graphics modes available, the 
assembly language routine shown as Program 7.4 
generates a checkerboard pattern on the screen. As 
each graphics mode has different requirements , the 
appropriate constants have been defined using an EQU 
directive so that they may be easily altered for 
another mode. The appropriate equates are defined along 
with the description of each of the graphics modes and 
are initially set up for the colour graphics 1 mode. 

The method used to generate the checkerboard pattern 
is to set up alternating on-off patterns in the video 
RAM byte and then write a complete row of such bytes to 
the screen. After a row has been written, the on-off 
patterns are reversed and another row written. This 
means that an on-pattern falls immediately below an 
off-pattern which is black thus creating the 
checkerboard . 

When in colour graphics mode, two bits are used to 
define each screen location so the appropriate on-off 
pattern in the video RAM byte is 00110011 . This is 
encoded, in hexadecimal, as $33. 



DSTART EQU $0600 

DSIZE EQU 1024 

DEND EQU DSTART+DSIZE 

DWIDTH EQU 16 

DBITS EQU $33 



Display start address 
Display size 
Display end address 
Display width in bytes 
Display bit pattern 



ORG $4E21 
PATGEN PSHS A,B,X 
LDX #DSTART 
LDA #DBITS 
LDB #DWIDTH 

NXTCOL STA 0,X+ 

DECB 

BNE NXTCOL 
COMA 

LDB #DWIDTH 
CMPX #DEND 
BLO NXTCOL 
PULS A,B,X,PC 



Set up code address 
Save registers 
Set up base address 
Set up pattern 
Set up width 
generate pattern 

are we finished? 
yes, complement pattern 
and reset row length 
Reached end of display 
no, do next column 
restore and return 



Program 7.4 Checkerboard routine 
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7.4.1 The colour graphics 1 mode 

This mode provides a 64 element wide by 64 element high 
four colour graphics display and is referred to as the 
1C mode. As the display screen is 256 by 192 pixels, 
this means that each element is 4 pixels by 3 pixels in 
size. Given that the code for 4 screen elements can be 
held in each byte, the display memory requirement for 
this mode is therefore 1024 bytes. 

The pattern generator program is set up initially in 
this mode. However, as the BASIC PMODE command does not 
recognise this particular mode, the SAM and VDG chips 
have to be set up directly in the BASIC test rig by 
poking values into their control registers. It is still 
possible to use the SCREEN command to select the 
graphics screen since this is independent of the mode. 
It is also possible to use one of the colour graphics 
PMODEs (1 or 3) to set up the start page and PCLS to 
clear the screen graphics display since the byte format 
is the same. This does mean that 3072 (3C) or 

6144 (6C) bytes will be cleared when only 1024 bytes 
need be but this is not usually a problem. 

The following amendments to Program 7.1 configure 
the graphics hardware for the 1C mode . 

1010 PMODE 1,1 

1022 POKE &HFFC1,1 'Set VO in SAM 

1024 POKE &HFFC2, 'Clear VI in SAM 

1026 POKE &HFFC4,0 'Clear V2 in SAM 

1028 POKE &HFF22, &H80 'Configure VDG 

The lines 1022-1028 are used to configure the VDG and 
SAM directly and therefore override the PMODE 1 
command . 

7.4.2 The colour graphics 2 mode 

The display generated by this mode is in four colours 
on a 128 by 64 grid. Elements are made up of 2 by 3 
pixels and a total of 2048 bytes of video RAM is 
required to support this mode . To convert the 

checkerboard generator to this mode, the following 
equates must be made: 

DSIZE EQU 2048 
DWIDTH EQU 32 

Again, the programmer must configure the SAM and VDG 
chips by the use of POKEs to set their control 
registers. The amendments to the BASIC test rig below 
set these devices for this mode. 

1010 PMODE 1,1 

1022 POKE &HFFCO, 

1024 POKE &HFFC3,1 

1026 POKE &HFFC4, 

1028 POKE $HFF22,&HA0 'Configure VDG 
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7.4.3 The colour graphics 3 mode 

This mode considers the screen to be made up of 128 by 
96 elements and, like all the colour graphics modes, 
can display up to four colours. The total video RAM 
requirement for this mode is 3072 bytes or two high- 
resolution graphics pages. 

To reconfigure the checkerboard program for this 
mode requires the following redefinitions 

DWIDTH EQU 32 
DSIZE EQU 3072 

BASIC recognises this mode so the hardware can be set 
up using a PMODE 1 command. 

7.4.4 The colour graphics 6 mode 

This is the highest resolution colour graphics mode. 
The screen is made up of 128 by 192 elements and there 
are four possible colours. Elements are each 2 by 1 
pixels in size. The memory requirements for this mode 
are 6144 bytes which needs four high-resolution 
graphics pages. 

The following alterations to the pattern generator 
program are needed: 

DSIZE EQU 6144 
DWIDTH EQU 32 

Again, this mode is recognised by BASIC and can be set 
up by using a PMODE 3,1 command. 

7.5 RESOLUTION GRAPHICS DISPLAY MODES 

Resolution graphics, as the name implies, are more 
concerned with screen resolution rather than colour so, 
in these graphics modes, the colours are limited. The 
display is black on a background colour or a foreground 
colour on black. 

The background or foreground colours are green and 
buff as shown in the table below. 



CSS 


Colour 


RAM 


bit 


value 





Black 












Green 




1 




1 


Black 









1 


Buff 




1 





In resolution graphics, each element in the display is 
controlled by a single bit which means that an element 
can be one of two colours. 

The bit pattern used to define the checkerboard 
consists of bits with alternating values, that is, 
01010101, so for all resolution graphics modes the 
DBITS constant in Program 7.4 is set to $55. 



The general format of a video RAM 
resolution graphics is shown in Figure 1.2. 
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byte for 



cccccccc 



E7 E6 E5 E4 E3 E2 E1 EO 

Fig. 7.2 Resolution graphics byte format 



There are four resolution graphics modes which are 

given the names 1R, 2R, 3R and 6R. These are the 

resolution graphics equivalents of modes 1C, 2C, 3C, 
and 6C and each is described below. 

7.5.1 The resolution graphics 1 mode 

This mode generates a 128 element wide by 64 element 
high two-colour graphics display . Each element is 
controlled by a single bit in the video RAM byte and is 
2 pixels by 3 pixels in size. The total memory 

requirements for this mode are 1024 bytes. Like the 1C 
mode, this mode is not supported directly by BASIC. 

The pattern generator can be altered for this mode 
by redefining some of the constants as follows: 

DSIZE EQU 1024 

The BASIC test rig must be modified to set up the VDG 
and SAM chips but a PMODE command followed by a PCLS 
will clear enough screen bytes for this mode. The 
following amendments to the BASIC test rig will 
configure the VDG and SAM chips for the 1R mode. 

1022 POKE SHFFC1,1 'Set VO in SAM 

1024 POKE &HFFC2, 'Clear VI in SAM 

1026 POKE &HFFC4, 'Clear V2 in SAM 

1028 POKE &HFF22,&H90 'Configure VDG 

7.5.2 The resolution graphics 2 mode 

This resolution graphics mode generates a display of 
128 elements wide by 96 elements high. This means that 
each element is 2 pixels by 2 pixels in shape. Its 
memory requirements are 1536 bytes or 1 high-resolution 
graphics page. 

The checkerboard program may be modified for this 
mode by redefining the equates as follows: 

DSIZE EQU 1536 

The 2R mode is supported by BASIC and can be invoked by 
issuing a PMODE command. 
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7.5.3 The resolution graphics 3 mode 

This mode generates a 128 by 192 element display in two 
colours. Each element is 2 pixels by one pixel and the 
total memory requirement is 3072 bytes. 

To reconfigure the pattern generator for this mode 
only requires DSIZE to be equated to 3072. The mode is 
supported by BASIC as PMODE 2. 

7.5.4 The resolution graphics 6 mode 

This is the highest resolution mode possible since each 
pixel is controlled by a single bit in the video RAM. 
The display is arranged as a 256 by 192 pixel grid and 
therefore the video RAM size required for this is 6144 
bytes. To set up the checkerboard routine for this mode 
requires DSIZE to be equated to 6144 and the BASIC test 
rig must be modified so that a PMODE 4 command is 
issued. 

7.6 SEMIGRAPHICS DISPLAY MODES 

As well as graphics and alphanumeric modes, the VDG 
chip has two Semigraphics modes where special-purpose 
characters representing graphics symbols can be built 
up and displayed on the screen. As the fundamental 
display element is the character, it is possible to mix 
these graphics characters with normal alphanumerics 
thus allowing text and graphics to appear together on 
the Dragon 's display. Furthermore, the use of a 
Semigraphics mode allows the use of eight-colour rather 
than four-colour graphics, thus opening up more 
creative possibilities for the graphics programmer. 

The in-built Semigraphics modes are termed 
Semigraphics 4 and Semigraphics 6 modes with the 
associated number referring to the number of elements 
making up a graphics character. As well as these in- 
built modes, it is also possible to set up three 
additional Semigraphics modes (8, 12, 24) by setting 
the VDG chip in alphanumeric mode and the SAM chip in 
2C, 4C, or 6C colour graphics mode. Details of these 
additional modes are briefly described below and fully 
described in Appendix 2. 

When in Semigraphics mode, each character is made up 
of a number of elements. The character organisation 
for Semigraphics 4 mode is shown as Figure 7.3. The 
other modes have a similar pixel organisation although, 
obviously, they offer higher resolution graphics as 
each character is made up of more elements. In all 
cases, the horizontal width of an element is 4 pixels 
but the vertical width varies from 1 to 6 pixels. Apart 
from the Semigraphics 6 mode, all of the Semigraphics 
modes allow eight-colour graphics and use three bits in 
each byte to represent the colour of the character 
elements represented in that byte. Bits 4-6 in the 
byte hold the colour information and the table below 



167 

defines the colours associated with each three-bit 
colour value. 



Colour 


Bit pattern 


Green 


000 


Yellow 


001 


Blue 


010 


Red 


Oil 


Buff 


100 


Cyan 


101 


Magenta 


110 


Orange 


111 



L3 



L2 



LI 



ID 



Fig. 7.3 Semigraphics 4 character organisation 



A Semigraphics byte Is arranged so that bits 0-3 hold 
the settings of character elements , bits 4-6 hold the 
colour and bit 7 Is the mode bit. In Semigraphics 4 
and 6 modes, bit 7 Is 1, In Semigraphics 8, 12, or 24 
modes, bit 7 Is 0. All elements that are 'on' are 
displayed In the colour specified In bits 4-6 and 
elements which are 'off are displayed as black. There 
Is no way that elements represented In the same byte 
can take different colours. 



7.6.1 The Semigraphics 4 mode 

In Semigraphics 4 mode, each character Is split Into 4 
elements of size 4 by 6 pixels. A single video RAM 
byte Is therefore needed to hold each character where 
bits 0-3 are named L0-L3. 

To experiment with this mode, you might like to 
modify Program 7.2 which manipulates the INV bit In the 
video RAM bytes. Rather than manipulate bit 6, you 
manipulate bit 7 using AND, OR and EOR Instructions. 
These will turn the Semlgraphlc mode on and off. 

7.6.2 Semigraphics 6 mode 

The Semigraphics 6 mode splits each character Into 6 
elements of size 4 by 4 pixels giving a display 
resolution of 64 horizontal by 48 vertical elements. 
Each element Is controlled by a bit In the video RAM 
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byte so, as a single byte Is used for each character 
position in this mode, six bits of that byte are 
required to encode element settings. This leaves only 
two bits (bits 6 and 7) for colour information so only 
four colours may be represented. As in the colour 
graphics modes, the setting of CSS determines which 
colour set is used. 

In fact, the number of colours available in this 
mode is even more restricted as bit 7 has a double 
function as a colour coding bit and as a mode setting 
bit. In order to remain in Semigraphics mode, bit 7 
must always be set to 1 so this means that only blue 
and red from colour set and magenta and orange from 
colour set 1 may be used. 

7.6.3 The Semigraphics 8 mode 

The Semigraphics 8 mode is the first of the extra 
Semigraphics modes which can be used by setting up the 
VDG chip to alphanumeric mode and the SAM chip to one 
of the colour graphics modes. In this mode, a standard 
8 by 12 pixel character is split into eight elements of 
4 by 3 pixels. 

In order to set up the Semigraphics 8 mode from 
BASIC you must issue a SCREEN 0, command to put the 
VDG chip into alphanumeric mode then poke the bit value 
Oil into the SAM control bytes as shown in the graphics 
examples above. 

In this mode, 4 bytes of video RAM are required to 
represent each character position and only the bottom 
two bits (ID and LI) are used to hold element settings. 
As before, bits 4-6 hold the colour value and bit 7 
should be set to indicate Semigraphic mode. Bits 2 and 
3 are not used but should be set so that bit 2 has the 
same value as bit and bit 3 is the same as bit 1 . 

Each character is built up as 4 rows of 4 by 3 pixel 
elements. However, the bytes representing these rows 
are not contiguous but are actually spaced 32 bytes 
apart . The reason for this is that the SAM chip is 
configured to a colour graphics mode where the image is 
built up row by row, with each complete row taking up 
32 bytes. As Semigraphic elements consist of a number 
of rows, this means that the bytes specifying the 
element must be set up at this spacing. 

As four bytes are used, it is possible to mix 
element colours when using this mode as, obviously, 
each pair of elements in a byte has its own colour 
information. Furthermore, it also allows character 
rows from different characters to be incorporated into 
new characters and symbols. This means you can provide 
facilities such as character underlining by switching 
to Semigraphics mode at the appropriate time. 

However, using this facility requires great care as 
you must build up each character individually with each 
row of elements defined in a separate byte. You also 
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have the problem of spacing character definition bytes 
32 bytes apart as explained above so we recommend that 
you write a program to help you organise byte layout if 
you wish to use this facility. 

7.6.4 The Semigraphics 12 mode 

In this mode, the VDG chip is set to alphanumeric mode 
and the SAM chip to colour graphics 4C mode. Each 
character element is represented by twelve 4 by 2 pixel 
elements held in six bytes. As in the Semigraphics 4 
mode, only the bottom two bits per byte are used for 
element settings and different bytes may be set to 
different colours. 

To set up this mode, you must issue a SCREEN 0, 
command from BASIC then poke the value 001 into the SAM 
control bytes. 

7.6.5 The Semigraphics 24 mode 

In this mode, the SAM chip is set up to 6C mode and 
each character element is made up of twenty four 4 by 1 
pixel elements thus giving a screen resolution of 64 by 
192 elements . A total of 12 bytes is required to hold 
these element settings and, again, the colour of the 
two elements represented in each byte may be set up 
independently . 

To set up this mode, you must issue a SCREEN 0,0 
command from BASIC then poke the value Oil into the SAM 
control bytes. 

7. 7 GRAPHICS UTILITIES 

So far we have shown how the various display modes can 
be set up from BASIC and we have assumed that this is 
carried out before an assembly code graphics routine is 
called. Sometimes, setting up the display hardware 
from BASIC is neither possible nor desirable so in this 
section we describe how BASIC commands such as SCREEN, 
PMODE, PCLS, etc. may be implemented in assembly 
language . 

We have described, in section 7.1, the various 
hardware control bits and have explained that they are 
set up via memory-mapped I/O addresses . Remembering 
which bit means what is difficult, so it is good 
practice to set up mnemonic names for the various 
control bit settings. A table of equates defining 
these names, which we use throughout the remainder of 
this chapter, is shown below. 

* VDG/PIA and SAM addresses 

* 

VDGPIA EQU $FF22 ; Port B of PEA - VDG control 

SAMVOC EQU $FFCO ; Used to clear VO 

SAMVOS EQU $FFC1 ; Used to set VO 

SAMV1C EQU $FFC2 ; Used to clear VI 
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SAMV1S EQU $FFC3 ; 

SAMV2C EQU $FFC4 ; 

SAMV2S EQU $FFC5 ; 

SAMFOC EQU $FFC6 

* VDG/PIA bit patterns 
* 



ALPHAI 
ALPHAE 
M0DES4 
MODES 6 
MODES8 
MODS 12 
M0DS24 



EQU $00 
EQU $10 
EQU ALPHAI 
EQU ALPHAE 
EQU MODES4 
EQU MODES4 
EQU M0DES4 



Used to set VI 

Used to clear V2 

Used to set V2 

Base address of F0-F6 

- assumes CSS=0 

Internal alphanumeric 
External alphanumeric 
Semigraphics 4 
Semigraphics 6 
Semigraphics 8 
Semigraphics 12 
Semigraphics 24 



* Full graphics modes 



M0DE1C 
MODE1R 
MODE2C 
MODE2R 
MODE3C 
MODE3R 
MODE6C 
MODE 6 R 



EQU $80 

EQU $90 

EQU $A0 

EQU $B0 

EQU $C0 

EQU $D0 

EQU $E0 

EQU $F0 



Graphics 1C 
Graphics 1R 
Graphics 2C 
Graphics 2R 
Graphics 3C 
Graphics 3R 
Graphics 6C 
Graphics 6R 



Normally, the modes of the VDG and the SAM chip are the 
same but for some of the extra Semigraphics modes they 
must be set up differently . Therefore, rather than use 
a single routine with complex parameters to set up 
these devices, it is better to use two separate 
routines . The routine to configure the VDG chip is 
called VDGMOD and the routine to configure the SAM chip 
is SAMMOD . They are shown below as Program 7.5. 

* VDGMOD - sets up VDG chip 

* Sets control lines A/G, GM0-2, and CSS 



* Register input A - configuration bit pattern 

* to be written to PIA 

* Note only bits 3-7 of PIA are set so bits 0-2 must 

* be preserved 



Preserve setup pattern 

Preserve bottom bits 

of PIA register 

Or in setup pattern 

Setup VDG 

Restore and return 



* 






VDGMOD 


PSHS A 


/ 




LDA VDGPIA 


r 




AND A #7 


r 




ORA ,S 


r 




STA VDGPIA 


/ 




PULS A, PC 


/ 



* SAMMOD - Setup SAM chip 



* Register input A - bit pattern used to set up VDG 



Ill 



* In general, V0,V1,V2 in SAM are set up as GMO, 1, 2 

* in VDG but there are three special cases: 

* If A/G = then V0V1V2 = 000 

* If A/G = 1 and GM0GM1GM2 = 000 then V0V1V2 = 100 

* If A/G = 1 and GM0GM1GM2 = 111 then V0V1V2 = Oil 



SAMMOD 


PSHS A 


, 


Preserve VDG pattern 




STA SAMVOC 


f 


Clear VO 




STA SAMV1C 


r 


Clear VI 




STA SAMV2C 


f 


Clear V2 




ANDA #$F0 


r 


Clear bottom 4 bits of A 




BPL NOTGMO 


r 


Text mode (B7=0) 




CMP A #M0DE1C 


r 


no, is it 1C? 




BNE N0T1C 








ORA #$10 


r 


yes, special case->lR 


N0T1C 


CMP A #M0DE6R 
BNE N0T6R 


r 


Is it 6R 




ANDA #$E0 


f 


yes, special case->6C 


N0T6R 


ROLA 


f 


Get rid of A/G bit 




BPL N0TGM2 


f 


GM2 set? 




STA SAMV2S 


r 


yes, set V2 


N0TGM2 


ROLA 


r 


get rid of GM2 bit 




BPL N0TGM1 


r 


GM1 set 




STA SAMV1S 


r 


yes, set VI 


N0TGM1 


ROLA 


r 


get rid of GM1 bit 




BPL NOTGMO 


f 


GMO set? 




STA SAMVOS 


f 


yes, set VO 


NOTGMO 


PULS A, PC 


r 


Restore and return 




Program 7.5 VDG 


and SAM setup routines 



These routines set up the SAM and VDG chips. Normally, 
these devices are configured in the same mode so the 
bit pattern defining the VDG's control bits is set up 
in register A and each routine is called in turn. 

* GMODE - sets up graphics hardware 



- VDG's control bit settings 



* Register input A 
* 

GMODE BSR VDGMOD 

BSR SAMMOD 
RTS 

You can use this routine in conjunction with the equate 
table defined above to set up any of the graphics 
modes . You simply have to load the A register with the 
mode required then call GMODE to configure the VDG and 
SAM chips. The exceptions to this are when Semigraphics 
8, 12, or 24 modes are to be set up when VDGMOD and 
SAMMOD must be called individually to configure the VDG 
and SAM chips to different modes. 
For example: 
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* SEMI8 - selects Semlgraphlcs 8 mode 

SEMI 8 IDA #ALPHAI ; Alphanumeric mode 

BSR VDGMOD / for VDG 

IDA #MODE2C ; and 2C mode 

BSR SAMMOD ; for SAM 

RTS 
* 

* FULL6R - Selects resolution graphics 6 mode 
* 

FULL6R IDA #MODE6R 
BSR GMODE 
RTS 

These mode setup routines combine some of the features 
of BASIC'S PMODE and SCREEN commands which, together, 
set up the mode required, define the colour set and 
determine which graphics pages are to be used. In fact, 
it is better programming practice for a routine to do 
one thing and one thing only so we have defined 
separate assembly code routines to select the colour 
set and to define the starting page. These are shown as 
Program 7.6. 

* CSS - Select colour set 

* Input register A = -> colour set 

* = 1 -> colour set 1 



CSS 


PSHS A 


■ Preserve A 




IDA VDGPIA 


; Read current state of VDG 




TST ,S 


; Check set selection 




BEQ CSSO 






ORA #8 


; Set the CSS line 




BRA XIT 




csso 


ANDA #$F7 


; Clear the CSS line 


XIT 


STA VDGPIA 


; update the VDG 




PULS A, PC 


; Restore and return 



* To set up the SAM control bits, we must manipulate 

* 7 bits. We use the utility routine 

* from page 16 of Appendix 2 to carry out 

* this bit manipulation 
* 

* SAMSET - Configures SAM control bits 

* Register inputs X - address in SAM control register 

* A - SAM configuration bit pattern 

* B - number of bits to be copied from 

* A to SAMCR 

* NB. This routine does not preserve registers 

SAMSET LSRA ; Shift bit to carry 

BCC NOTSET ; Set corresponding CR bit? 
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NOTSET 
CHKCNT 



LEAX 1,X 

STA 0, X+ 

BRA CHKCNT 

STA 0, X++ 

DECB 

BNE SAMSET 

RTS 



Yes, odd address 

set bit and adjust X for 

next address 

Clear bit and continue 

All done? 

Yes, return 



* SAMSET is used by PAGEX to set the page number 

* in the control register. This is passed to PAGEX 

* as a 16-bit address and PAGEX selects the top 7 bits 

* to get the graphics segment base address. This means 

* that you can pass an address within a segment 

* not just the segment base address 



* PAGEX - Set up graphics segment base address 



* Register inputs X - Address of or within display area 

PAGEX PSHS X,D 

TFR X,D 



LSRA 

LDB #7 

LDX #SAMFOC 

BSR SAMSET 

PULS X,D,PC 



Save registers 
A = X(HI) , B = X(LO) 
We only need top 7 bits 
as specified in B 
Copy to F0-F6 

Restore and return 



Program 7. 6 Colour set and graphics page setup 

We have now defined those utility routines which allow 
the assembler programmer to dispense with BASIC'S 
SCREEN and PMODE commands and also with any POKEs that 
are needed to set up extra graphics modes from BASIC. 
We leave it as an exercise for the reader to convert 
the BASIC test rig, defined as Program 7.1 to assembly 
code. 

Now let us look at other useful graphics utility 
routines which may be used by the assembly language 
programmer. The first of these is a routine to clear 
the screen to a given colour. 



* CLS - Clear screen to specified colour 



* Register input B 
* 

* 
* 
* 



CLS 



PSHS X,B 

TSTB 

BEQ SEMION 

DECB 

ASLB 

ASLB 



colour specification 

= Black, 1 = Green, 2 = Yellow, 

3 = Blue, 4 = Red, 5 = Buff, 

6 = Cyan, 7 = Magenta, 8 = Orange 



Save registers 

B = is special case 

as all elements turned off 

BASIC -> VDG colour code 

Move colour code bits 

into bits D4-D6 
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SEMION 
NXTBYT 



ASLB 

ORB #$0F 

ORB #$80 
LDX #$400 
STB ,X+ 
CMPX #$5FF 
BLS NXTBYT 
PULS X,B,PC 



Turn on all elements 

Set up Semlgraphlcs bit 

Set default screen address 

Colour element 

on the screen 

If not finished, repeat 

Restore and return 



Program 7. 7 Clear screen 

When considering the graphics screen, the programmer 
thinks in terms of row and column numbers but, in 
memory, the screen is simply a one-dimensional 
contiguous area. There are 32 character bytes per row 
so it is useful to have a routine which, given a row 
and column number, translates this to the appropriate 
address. This routine, R32C0L, is also useful for full 
graphics modes which have 32 bytes of colour/resolution 
information per row. Other graphics modes need a 
variation of this which is easily derived by replacing 
the LDB #32 instruction with an LDB #16 instruction. 
The code for this routine is shown below. 

* R32C0L - Calculate screen position 

* Register inputs B - column number 

* A - row number 

* Register output D - screen position 

* Calculates position as A * 32 + B 



R32C0L 



STB ,-S 
LDB #32 
MUL 

ADDB ,S+ 
ADCA #0 
RTS 



Save column on stack 
Set up multiplier 
D = A * 32 
D = D + B 
Propagate carry 



1.8 DESIGNING AND IMPLEMENTING GRAPHICS PROGRAMS 

An essential first step in the design of a graphics 
program is to sketch out the graphics symbols which you 
would like to use in your program. Examples of such 
symbols are space-ships, laser bursts, bombs, 
explosions, etc. if you are writing games programs, and 
character fonts, pie charts, maps, etc. if you are 
concerned with more serious applications. 

A well-designed graphics program is built up 
incrementally with later developments built up on 
earlier design stages. It is therefore very important 
that assembly language routines should be as flexible 
and as general-purpose as possible. In this section we 
discuss various tools and techniques used in the design 
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and implementation of graphics symbols and we use the 
Dragon logo as an example of a symbol that might be 
used in a graphics program. 

7.8.1 Graphic symbol design 

The first stage in graphics symbol design is to make a 
very rough sketch of the symbol required and, depending 
on the details of the symbol, choose the most 
appropriate screen resolution for that symbol. It 
might seem that it is always best to use the highest 
resolution but this may limit the colours available 
and, in fact, may mean more work in symbol design as 
the setting of more picture elements has to be 
considered. 

Another factor which must be taken into account is 
the height to width ratio of your symbol . Some modes 
have picture elements which are square and others have 
elements which are longer than they are high. For our 
example, the Dragon logo is slightly longer than it is 
high so the most appropriate resolution to chose is 128 
by 192 elements. This means using either the colour 
graphics 6 mode, if a colour display is required, or 
the resolution graphics 3 mode, if a foreground colour 
on black is all that is wanted. 



Byte Byte 1 

012345670T234567 
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Fig. 7.4 Grid representation of Dragon logo 



Once you have decided on the resolution to use, the 
next thing to consider is the size of the symbol. 
Obviously, you must choose a size which is appropriate 
for the resolution. For our example, we have chosen 
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that the Dragon logo should be contained In a 16 by 16 
element grid. 

The next stage is to work out how to set up the 
picture elements in this grid so that the shape of a 
Dragon is produced. The easiest way to do this is to 
use a graphics worksheet, which is simply lined graph 
paper with the same height to width ratio as the chosen 
resolution. If this is not available, squared paper can 
be used but you must take into account any differences 
in the height to width ratio. The grid representation 
of the Dragon logo is shown as Figure 7.4. 

Once the symbol has been mapped out on the graphics 
worksheet, the binary patterns for each row must be 
encoded and included as data for the assembly language 
program. The simplest way to do this is to make up a 
data array of constant byte values using the assembler 
directives FCB and FDB. This process is 

straightforward when resolution graphics is used but 
requires rather more care when colour is required as 
there is not a one-to-one relationship between symbols 
on the worksheet and bits in the data byte. 

Let us take the easiest case first and look at how 
the graphic grid can be converted to resolution 
graphics data bytes. Since there is a one-to-one 
relationship between the screen elements and the grid 
elements, row 0, byte is encoded as $00 (all elements 
off) and row 0, byte 1 is encoded as $3F (00111111) . 
Row 1, byte is encoded as $20 (00100000) , row 1, byte 
1 as $3F, and so on. Therefore, the first few bytes of 
the assembly language data table might be written as 
follows : 

FCB $00 
FCB $3F 
FCB $20 
FCB $3F 

However, as we are dealing with a 16-bit entity, it is 
better practice to encode the information as a single 
16-bit value using FDB directives. For example: 

FDB $003F 

After you have worked out the appropriate byte values, 
you should then label the table with a symbolic name 
such as DRAGON. The complete table for the Dragon logo 
is shown below: 

DRAGON FDB $003F ;Row bit pattern 
FDB $203F ;Row 1 bit pattern 
FDB $F860 
FDB $18DE 
FDB $E9BC 
FDB $2B7C 
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FDB $52E0 
FDB $B6C0 
FDB $BFFC 
FDB $BFFE 
FDB $C007 
FDB $7 FEB 
FDB $3FFD 
FDB $140A 
FDB $2814 
FDB $0000 ;Row 15 bit pattern 

After encoding the graphics symbol, the next step is to 
design a routine which takes the encoded symbol and 
displays it on the screen. Because the display is 
memory mapped, all that you need to do is to copy the 
data from the graphics symbol table into the 
appropriate locations in the video RAM. The copy 
routine must map the row/column representation of the 
screen onto the video RAM which is organised as a 
linear sequence. As the Dragon logo only takes up part 
of the screen, succeeding row addresses are actually 
located 16 bytes from each other in this resolution 
graphics mode. 

This is an example of a situation where you should 
write a general-purpose routine which can carry out the 
mapping of data tables to screen locations for any 
graphics mode. This routine has to satisfy the 

following design criteria: 

(1) It must be able to move data from any source ad- 
dress to any destination address. 

(2) It must be able to cope with any row separation. 

(3) It must be able to cope with any number of rows. 

(4) It must not interact, in any way, with its cal- 
ling program. 

A general-purpose copy routine which meets these 
criteria is shown as Program 7.8. 

* C0PY2B - Copies 2 byte chunks to video RAM 

* Register inputs X - destination address (in RAM) 

* Y - source address 

* B - row width (number of bytes 

* between video RAM addresses) 

* A - number of rows (number of words 

* to copy) 

C0PY2B PSHS X,Y,U,A,B ; Save registers 

NEXT2B LDU , Y++ ; Pick up source word 

STU ,X ; and store in row 
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ABX 

DECA 

BNE NEXT2B 

PULS X, Y, U, A, B, PC 



/ Add row width 
; Repeat until all 
; rows dealt with 
; Restore and return 



Program 7.8 C0PY2B - update video RAM 

An example of how this routine might be used is shown 
in the program fragment below which displays the Dragon 
logo in the top left hand corner of the screen . 



DSTART EQU $0600 
DWIDTH EQU 16 

LOGOTL LDX #DSTART 

LEAY DRAGON, PCR 

LDB #DWIDTH 

LDA #16 

BSR C0PY2B 

RTS 



Display start 
Display width 

Destination address 
Source address 
Display width 
Number of rows 
Transfer logo to screen 



Now that we have managed to draw a dragon in the corner 
of the screen, we can now go on to repeat the pattern 
over and over again . 

* FILLER - fills screen with dragons 
* 

* Register inputs NONE 

* Registers destroyed X,Y,A,B 



FILLER 



NXTPOS 



LDX #DSTART 
LDB #DWIDTH 

LDA #16 

LEAY DRAGON, PCR 
BSR C0PY2B 

LEAX DWIDTH+2,X 
CMPX #DEND-512 
BLS NXTPOS 
RTS 



Destination address 
Colour display row width 
Number of display rows 
Address of source 
Now start copying 
dragons diagonally 
until no room left 
for another one 



Program 7.9 FILLER - fills screen with dragons 

Now let us look at how the Dragon logo can be displayed 
using the colour graphics 6 mode which allows a four- 
colour display at the same resolution. The first stage 
in this process is to convert the grid pattern to the 
appropriate four-colour data bytes. 

The best way to tackle this is to encode the diagram 
as if it was to be displayed in resolution graphics 
then convert every element that is off (0) to the 
chosen background colour (green in this case) and 
convert elements which are on to the chosen foreground 
colour (red, naturally) . This means that the colour 
data table is twice the size of the resolution graphics 
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data table because two bits rather than a single bit 
are used to represent each screen element . Examples of 
the conversion of resolution data to colour data are 
shown below. 

Resolution data Colour data 
$00 $0000 

$3F $OFFF 

$20 $0C00 

The conversion from the resolution grid data to colour 
data is a tedious, mechanical, error-prone process 
which means that it is ideal for automation. Program 
7.10 below is a BASIC program which does the conversion 
for you. 

100 PRINT"RES0LUTI0N TO COLOUR GRAPHICS" 

110 PRINT "DATA CONVERSION PROGRAM" 

120 PRINT "COLOURS AVAILABLE ARE: " 

130 PRINT"C0L0UR SET 0" 

140 PRINT" GREEN 1, YELLOW 2" 

150 PRINT" BLUE 3, RED 4" 

160 PRINT"COLOUR SET 1" 

170 PRINT" BUFF 5, CYAN 6" 

180 PRINT" MAGENTA 7, ORANGE 8" 

200 INPUT "BACKGROUND COLOUR (1-8) ";BG 

210 IF (BG<1) OR (BG>8) THEN 120 

220 INPUT "FOREGROUND COLOUR (1-8) ";FG 

230 IF (FG«1) OR (FG>8) THEN 120 

240 IF (BG<5) AND (FG<5) THEN 300 

250 IF (BG>4) AND (FG>4) THEN 290 

260 PRINT "FOREGROUND /BACKGROUND NEED TO" 

270 PRINT "BE IN THE SAME COLOUR SET" 

280 GOTO 120 

290 BG=BG-4: FG=FG-4 'Convert to CS 

300 BG=BG-1: FG=FG-1 'Convert to VDG code 

310 PRINT "ENTER RESOLUTION GRAPHICS CODE" 

320 INPUT"BYTE (IN HEX) ";RB$ 

330 RB=VAL("&H"+RB$) 'Convert to numeric value 

340 BM=1 'Bit Mask (first power of 2) 

350 BP=1 'Bit Pair (first power of 4) 

360 CW=0 'Colour Word value (16 bits) 

370 BC=0 'Bit Colour (FG or BG) 

380 'Now convert the single resolution 

390 'bits into pairs of colour bits 

400 FOR BIT = TO 7 

410 IF (RB AND BM) THEN BC=FG ELSE BC=BG 

420 CW=CW+BC*BP 'Add colour pair to CW 

430 BM=BM*2 'Next power of 2 

440 BP=BP*4 'Next power of 4 

450 NEXT BIT 

460 PRINT" COLOUR CODE WORD (HEX) IS " ; HEX$ (CW) 

470 PRINT: GOTO 310 

Program 7.10 BASIC colour conversion program 
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The complete data table for the Dragon logo as a red 
dragon against a green background is: 

DRAGON FDB $0000, $OFFF 

FDB $0C00, $OFFF 

FDB $FFCO, $3C00 

FDB $03C0, $F3FC 

FDB $FCC3, $CFFO 

FDB $OCCF, $3FF0 

FDB $330C,$FC00 

FDB $CF3C, $F000 

FDB $CFFF, $FFFO 

FDB $CFFF, $FFFC 

FDB $F000, $003F 

FDB $3FFF, $FCCF 

FDB $OFFF, $FFF3 

FDB $0330, $OOCC 

FDB $OCCO,$OOCC 

FDB $0000, $0000 

With this colour data table, the C0PY2B routine can now 
be used to update the 128 by 192 colour graphics 
display. However, the updating process is slightly 
more complex since 16 bits of data are needed to 
represent 8 elements . Therefore, it is best to modify 
this routine so that 4-byte chunks may be copied. This 
modification simply involves adding statements to copy 
another word before the ABX instruction. The code for 
this routine is provided as part of Program 7.12. 

7.8.2 Animating a graphics display 

Until now, all the graphics displays which we have 
discussed have been static in nature. In this section 
we describe how to create simple animation sequences. 
The technique used in animating graphics are very 
similar to those used in cartoon filming because the 
animation relies on rapidly flicking through different 
versions of a basic graphics symbol. If the flicking is 
sufficiently rapid, the movement will be smooth but if 
it is too slow, as is often the case with BASIC, the 
movement of the symbol is very jerky. 

To illustrate this technique we shall breath some 
life into the Dragon logo introduced in the last 
section. To be more exact, we shall breath some fire 
into the beast as it is well-known that no self- 
respecting dragon is without this mythical power. What 
we shall do is to add flames which will flare out from 
the dragon ' s mouth, flicker and dance and then die 
down. 

At first sight this might seem to be a difficult and 
complex task but, in fact, if tackled one stage at a 
time, it is relatively easy. The secret is to build up 
the flames one at a time, flicker the flames with 
slightly differing sequences and then extinguish the 
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fire in the opposite order to that used to build it up. 
This is best illustrated by means of an example. 

Say an 8 by 8 element grid is used to contain the 
flame pattern and the flame colour chosen is yellow. 
The data tables for building up the final flame 
sequence labelled FLAMEO to FLAMES are shown below. It 
is left as an exercise for the reader to reconstruct 
the actual flame patterns which have been used to 
derive this data. 

FLAMEO FDB $0, $0 , $0, $0, $0 , $0, $0, $0 

FLAME1 FDB$0, $0, $0, $5, $0, $0, $0, $0 

FLAME2 FDB $0 , $0 , $50 , $5 , $0 , $0 , $0 , $0 

FLAME3 FDB $0 , $0 , $50 , $5 , $150 , $0 , $0 , $0 

FLAME4 FDB $0 , $500 , $50 , $505 , $150 , $1400 , $0 , $0 

FLAME5 FDB $5000 , $500 , $1050 , $505 , $4150 , $1400 , $5000 , $0 

The first flame sequence (FLAMEO) is completely blank 
as this is used to extinguish the flames completely . 
The next flame sequence (FLAME1) is slightly more built 
up than FLAMEO, the sequence FLAME2 is more developed 
than FLAME1 and so on . 

Since 2 bytes of colour data has to be copied to the 
video RAM we can make use of the C0PY2B routine to set 
up the display area in memory. However, if we had used 
resolution graphics instead of colour graphics, then we 
would only have needed to copy 1 byte of resolution 
data to the video RAM. A routine called C0PY1B that 
performs this function is provided in this section for 
the sake of completeness . 

* C0PY1B - copy data in 1 byte chunks 
* 

* Register inputs X,Y,B as C0PY2B 

* A - number of bytes to copy 



C0PY1B PSHS X,Y,A,B 

STA , -S 
NEXT1B LDA , Y+ 

STA ,X+ 

ABX 

DEC ,S 

BNE NEXT1B 

LEAS 1,S 

PULS X, Y,A,B,PC 



Save registers 

Save count on stack 

Pick up row byte pattern 

and store it 

Add row width indicator 

Decrement count 

All rows done ? 

Discard local 

Restore and return 



Program 7.11 C0PY1B - video RAM update 



The next stage in the development of the animated 
sequence is to provide the means to display the 
individual flame sequences. This is also the time to 
consider the delay between sequence updates since too 
short a delay will result in the animation sequence 
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lasting only a fraction of a second whilst too long a 
delay will result in faltering effect. The following 
routine is used to implement a short delay and is based 
on a software delay loop. 

* DELAY - hold up activity for a while 

DELAY PSHS X ; Save register 

LDX #$4000 ; This value may be changed 

LOOP LEAX -1,X ; to adjust the timing 

BNE LOOP ; delay 

PULS X,PC ; Restore and return 

The next routine is typical of routines needed to 
display the individual sequences: 

FIREO LEAY FLAMEO,PCR / Set up flame sequence address 

FIRE BSR C0PY2B ; Update display with sequence 

BSR DELAY ; Stop for a while 

RTS 

The two subroutine calls to C0PY2B and to DELAY are 
common to all the updating routines so we can enter 
FIREO at label FIRE to allow them to be called as a 
subroutine. This is a fairly common and harmless trick 
of assembly language programming which serves to reduce 
the size of the finished code. 

The next routine, to continue the animation, makes 
use of this technique: 

FIRE1 LEAY FLAME1,PCR 
BSR FIRE 
RTS 

This process of routine development continues until you 
end up with a complete animation program. Program 7.12 
is an animated fire-breathing dragon which is an 
appropriate conclusion to this chapter. For brevity, 
we have not duplicated the code of routines which have 
been described earlier in this chapter. Rather, we 
have indicated by comments where these routines should 
be included. 



* ANIMATED DRAGON PROGRAM 

ORG 20001 

LBRA ACTION ; This preserves the entry point 

* DRAGON - Data for the Dragon logo 

* on a 16x16 colour grid 

* INCLUDE DRAGON DATA TABLE HERE 
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* Flame data follows. This is on an 8x8 colour grid 

* INCLUDE FLAME TABLE HERE 

* Constants used in the program follow 
* 

; Due to 128x196 colour mode 
; For a 16 row grid 
; For an 8 row grid 
; May be changed 



DWIDTH 


EQU 32 


ROWS 16 


EQU 16 


ROWS8 


EQU 8 


DSTART 


EQU $0600 



* INCLUDE VDG/PIA and SAM ADDRESS EQUATES HERE 

* INCLUDE VDGMOD, GMODE and SAMMOD ROUTINES HERE 

* FULL6C - Selects colour graphics 6 mode 
* 



FULL6C 



IDA #MODE6C 
BSR GMODE 
RTS 



* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 



INCLUDE CSS ROUTINE HERE 

INCLUDE SAMSET AND PAGEEX ROUTINES HERE 

INCLUDE COPY2B ROUTINE HERE 

COPY4B - Copies 4 byte chunks to video RAM 

Register inputs X - destination address (in RAM) 
Y - source address 
B - row width (number of bytes 

between video RAM addresses) 
A - number of words to copy 



COPY4B PSHS X,Y,U,A,B 
NEXT4B LDU , Y++ 

STU ,X 

LDU ,Y++ 

STU 2 r X 

ABX 

DECA 

BNE NEXT4B 

PULS X,Y,U,A,B,PC 



Save registers 
Pick up source word 
and store in row 
Pick up next word 
and store after first 
Add row width 
Repeat until all 
rows dealt with 
Restore and return 



* DELAY - hold up activity for a while 

DELAY PSHS X ; Save register 

LDX #$4000 ; This value may be changed 

LOOP LEAX -1,X ; to adjust the timing 

BNE LOOP ; delay 

PULS X,PC ; Restore and return 



* The following routines play with firei 
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* FIREO - Deals with the first flame sequence 

FIREO LEAY FLAMEO,PCR ; Set up address first pattern 

* FIRE - Used throughout the fire routines for display 
FIRE BSR C0PY2B ; Flames 8x8 in colour 

BSR DELAY ; Wait briefly 

RTS ; before returning 

* FIRE1 - Deals with the second flame sequence 

FIRE1 LEAY FLAME1,PCR 
BSR FIRE 
RTS 

* FIRE2 - Third flame sequence 

FIRE2 LEAY FLAME2,PCR 

BSR FIRE 

RTS 
* 

* FIRE3 - Fourth flame sequence 
* 

FIRE3 LEAY FLAME3,PCR 

BSR FIRE 

RTS 
* 

* FIRE4 - Fifth flame sequence 

FIRE4 LEAY FLAME4,PCR 

BSR FIRE 

RTS 
* 

* FIRE5 - Sixth flame sequence 

FIRE5 LEAY FLAME5,PCR 

BSR FIRE 

RTS 
* 

* KINDLE - Ignite (start the flame sequence) and 

* gradually build the fire up. 
* 

KINDLE BSR FIREO 
BSR FIRE1 
BSR FIRE2 
BSR FIRE3 
BSR FIRE4 
BSR FIRE5 
RTS 



* FLARE - Plays flames by varying flame sequences. 

FLARE BSR FIRE4 

BSR FIRE5 
BSR FIRE3 
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BSR FIRE1 

BSR FIRE4 

BSR FIRE3 

BSR FIRE5 
RTS 



* DOUSE - Gradually extinguish the flames 

* by reversing the sequence. 



* 






DOUSE 


BSR 


FIRE4 




BSR 


FIRE3 




BSR 


FIRE2 




BSR 


FIRE1 




BSR 


FIREO 




RTS 





Was at full flame 



Fire now out . 



* FLAMES - Animates the fire-breathing dragon . 
* 



FLAMES 



BSR KINDLE 
BSR FLARE 
BSR DOUSE 
RTS 



Kindle the fire. 
Play the flames. 
Now douse the fire. 



* ACTION - Set up the display and start the animation. 
* 



ACTION LBSR FULL6C 
LDA #0 
LBSR CSS 
LDX iDSTART 
LBSR PAGEX 
LEAX 16, X 
LEAY DRAGON, PCR 
LDB #DWIDTH 
LDA #R0WS1 6 

LBSR C0PY4B 
LEAX -2,X 
LDA #R0WS8 

RETAKE BSR FLAMES 
BRA RETAKE 



Select the graphics mode 
Choose colour set 

Set up the display start 

and select the page 

Get breathing space 

Set up dragon data 

and display width 

and number of rows 

for a 16x16 colour grid 

Flames come out of mouth! 

Now displaying flames 

on an 8x8 colour grid 

Repeat the animation 



Program 7.12 A fire-breathing Dragon 



Chapter 8 

Input/output programming 



The topic of input/output programming is one that is 
often neglected in books like this. The reason for 
this is that the subject is so detailed and complex 
that it is very difficult to present a coherent 
overview of it in a single chapter. However, we have 
tried to do so and, in this chapter, we explain some of 
the general principles of I/O programming and describe 
the specifics of the Dragon's I/O system. 

As we explained earlier in the book, the Dragon ' s 
I/O system is memory mapped which means that I/O 
devices (or more accurately controllers) are accessed 
by reference to specific memory locations. Reading or 
writing to these locations results in an I/O transfer 
from or to the I/O device. 

The Dragon ' s offers a variety of I/O interfaces such 
as a cassette interface, two joystick interfaces, a 
printer interface, etc. These are shown in Figure 8.1 
which is a block diagram of the Dragon's I/O system. 
Some of the terms in this diagram will be unfamiliar to 
the reader who is new to I/O programming but they will 
be explained as the chapter progresses . 

Because the I/O system is so complex, it is 
impossible for us to provide a description here which 
contains enough detail for the electronics enthusiast 
to connect his own devices to the system. Rather, we 
have concentrated here on information for the I/O 
programmer and have avoided going into specific details 
of the system electronics. Readers who want to 
interface hardware to the Dragon must use the data 
sheets presented in the appendices for complete 
hardware details of the I/O system devices. These data 
sheets have been provided by the chip manufacturer and 
contain complete details of the chip functions and 
signals. 

There are four major sections in this chapter. The 
first two are concerned with the generalities of I/O 
programming and cover the concept of interrupts and I/O 
programming techniques. The final two sections cover 
details of the Dragon 's I/O system, with section 3 
concentrating on the PIA chip, which is the principal 
interface controller on the system, and section 4 
describing the various I/O ports built into the system. 
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8. 1 INTERRUPTS 

The central concept on which much I/O programming is 
based is the notion of an interrupt . An interrupt is a 
signal to the processor to temporarily stop what it 's 
doing and carry out some other task. We shall explain 
the steps involved in this by means of an analogy. 

Say you are busy programming your Dragon when your 
doorbell rings. You stop what you are doing to answer 
the door and you find the occupier of the apartment 
below who tells you that water is dripping through his 
ceiling. You immediately rush to the bathroom where you 
find that you have left the water running and the bath 
has overflowed. You turn off the water, mop up the 
mess then go back to your programming. Whilst mopping 
up the bathroom you ignore other interruptions unless 
they are very urgent such as flames shooting from the 
cooker . 

In this scenario, events can be identified which 
correspond to the events which occur in a computer 
system when an interrupt is received and processed. 

(1) The interrupt 

This is the doorbell ringing to tell you to stop 
what you are doing as some other task requires 
your attention. A computer system has one or 
more interrupt request control lines. A signal 
on one of these lines is an interrupt which 
causes the currently executing task to be 
suspended and the interrupt processed. 

(2) The interrupt vector 

This is the front door. The interrupt (doorbell) 
tells you to go to a known place in order to 
start interrupt processing. In a computer there 
are usually several pre-determined memory loca- 
tions, called interrupt vectors. The program 
counter is automatically loaded with the contents 
of one of these locations when the interrupt is 
detected and this causes a transfer of control to 
an interrupt service routine. 

(3) The interrupt service routine 

This is the mopping up of the bathroom or, in 
other words, what you must do to clear the condi- 
tion causing the interrupt. In a computer the 
address of this routine is held in the interrupt 
vector and control is transferred automatically 
to it. 

(4) The interrupt mask 

This is, effectively, what you do when you ignore 
interruptions in order to get the water off your 
bathroom floor. In a computer it is usually pos- 
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sible to set up a so-called 'Interrupt mask ' 
which indicates that an interrupt is being pro- 
cessed and that no more interrupts should be ac- 
cepted until that processing is complete. 

(5) The priority interrupt 

This is the cooker catching fire. Some events 
are so urgent that they must be handled in spite 
of the fact that another interrupt-handling pro- 
cess is already underway. In a computer, there 
is often a non-maskable interrupt control line. 
A signal on this line means 'something urgent has 
happened' and must be processed immediately. 

(6) Process resumption 

After handling the interrupt, you can breath a 
sigh of relief and go back to programming. In a 
computer, the interrupted process is restarted 
and execution proceeds as if the interrupt had 
not occurred. 

Interrupts are very important in I/O programming 
because they are one way that a peripheral controller 
can tell the processor that data are ready for input or 
that the peripheral is ready to accept more data for 
output. If interrupts are not used the processor has 
to examine all the peripheral devices at periodic 
intervals to see if they have completed their input or 
output operations. 

The M6809 processor has a total of four interrupt 
request control lines, a number of interrupt handling 
instructions and uses three of the bits in the 
condition code register in its interrupt processing . 
Before going on to describe these in detail, however, 
we describe a typical sequence of actions which take 
place automatically when a 'normal ' interrupt occurs . 

The 'normal ' interrupt control line on the M6809 is 
called IRQ and a signal on this line causes the 
processor to suspend the currently executing process 
after it has completed execution of its current 
instruction. The processor then sets the Entire flag 
in the condition code register (CC.E) and pushes all 
the processor registers, except S, onto the S-stack. 

The processor then sets the IRQ Mask flag in the 
condition code register (CC.I) to indicate that an 
interrupt is being processed and that no more 
interrupts on IRQ should be accepted. PC is then 
loaded with the contents of the IRQ interrupt vector 
(memory locations FFF8:FFF9) which causes a transfer of 
control to the interrupt service routine whose address 
is held in the interrupt vector. 

The interrupt service routine services whatever 
condition caused the interrupt then returns to the 
interrupted process by executing a Return from 
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Int&rrupt instruction. This instruction restores the 
register contents thus transferring control back to the 
interrupted process when PC is restored and clearing 
the interrupt mask bit CC. I when CC is restored. 

As well as the standard interrupt request line IRQ, 
the M6809 also has three other interrupt request lines 
called NMI (non-maskable interrupt) , FIRQ (fast 
interrupt request) and RESET. 

The RESET line is used when the system is switched 
on . An interrupt on this line is not handled in the 
same way as other interrupts as, obviously, there is no 
executing process to be suspended. When the machine is 
switched on, a RESET signal causes transfer of control 
to a system initialisation routine in ROM which sets up 
the S-stack and causes some other process, which is 
usually the BASIC interpreter, to be initiated. 

The FIRQ interrupt line signals that fast interrupt 
processing is to take place. This is similar to the 
processing of an IRQ interrupt but instead of all 
registers being stacked and unstacked, only PC and CC 
are stacked before control is transferred to the 
interrupt service routine. The E flag in CC is unset 
to indicate that only CC and PC have been stacked. 

When an RTI instruction restores CC, the top stack 
location, it examines the CC.E flag to see if it must 
restore all other registers or if it is only necessary 
to restore PC. An FIRQ request causes the FIRQ mask in 
the condition code register (CC.F) to be set thus 
locking out other interrupts on FIRQ. 

The NMI interrupt line is used to signal an urgent 
interrupt which should not be ignored. If CC.I or CC.F 
is set, the processor ignores interrupt requests on IRQ 
and FIRQ but NMI interrupts are always processed 
irrespective of the settings of these flags. The 
processing sequence is the same as that for an IRQ 
request although, obviously, a different interrupt 
vector is used. 

As well as these hardware interrupts, the M6809 can 
also process so-called 'software interrupts ' . Software 
interrupts occur when an SWI instruction is executed 
and, like hardware interrupts, they have an associated 
interrupt vector and service routine. Software 

interrupts are handled in the same way as IRQ 
interrupts and will be discussed in more detail in the 
following section where the SWI instruction is 
described. 

In all, there are seven 'levels ' of interrupt which 
can be processed by the M6809. The table below shows 
the locations of the interrupt vectors associated with 
each of these. 

Vector location Associated interrupt 
FFF2-.3 SWI 3 

FFF4 : 5 SWI2 
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FFF6: 7 FIRQ 
FFF8:9 IRQ 

FFFA:B SWI 

FFFC:D NMI 

FFFE:F RESET 

The interrupt priorities are as follows: 

RESET > NMI > SWI > FIRQ > IRQ > SWI2 > SWI3 

Notice that this order is not the same as the order of 
the interrupt vectors. 

8.1.1 Interrupt handling instructions 

The sequence of actions described above which initiates 
an interrupt device routine takes place automatically 
whenever a hardware or software interrupt is detected. 
No explicit instruction is needed to start interrupt 
processing but a return from interrupt instruction is 
necessary to restart the interrupted process. 

We have already introduced, in Chapter 3, the four 
M6809 instructions which are used in interrupt 
processing . Now, we describe each of these 

instructions, SWI, CWAI, SYNC, and RTI, in more detail . 

RTI - Return from Interrupt 

This instruction is always executed as the last 
instruction in an interrupt service routine. The 
instruction unstacks the CC register and examines CC.E. 
If it is unset, RTI then unstacks the next two stack 
bytes to PC thus returning control to the interrupted 
process . 

If CC.E is set, this indicates that all the 
registers were stacked before entry to the interrupt 
service routine so RTI restores all register values 
from the stack. As PC is the last register restored, 
control is thus returned to the interrupted process. 

SWI - Software Interrupt 

There are three levels of software interrupt which may 
be used by the M6809 programmer. There are identified 
by the instructions SWI, SWI2, and SWI3 . Each of these 
has a different priority in the order SWI > SWI2 > 
SWI3 . The SWI instruction also has a higher priority 
than FIRQ and IRQ hardware interrupts and sets the 
interrupt mask bits CC.F and CC.I. 

The sequence of operations executed when an SWI 
instruction is executed is the same as that which takes 
place automatically when an IRQ interrupt is detected. 
The register values of the interrupted process are 
stacked and control is transferred, via the appropriate 
interrupt vector, to the interrupt service routine. 

The execution of an SWI instruction is not unlike 
calling a subroutine. The advantage to the programmer, 
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however, is that SWI instructions can be used to call 
system routines without the programmer having to know 
the routine address at either load or run time. 

CWAI - Wait 

The wait instruction is used to suspend the execution 
of a process until a hardware interrupt occurs. The 
instruction takes a single-byte operand which is anded 
with CC as the first step in the execution of the 
instruction. This means that the programmer can set up 
CC prior to its stacking and can guarantee the value of 
CC when the interrupted process is resumed. 

After the ANDCC operation, CWAI sets CC.E and stacks 
all the processor registers. It then does 

nothing (waits) until a hardware interrupt occurs. If 
this is an NMI or RESET interrupt, it is immediately 
processed but if it is an IRQ or FIRQ interrupt and the 
corresponding mask bit is set in CC, the instruction 
continues to wait until a higher priority interrupt 
occurs or until the interrupt mask is cleared. 

SYNC - Synchronise 

The synchronise instruction, SYNC, is used to 
synchronise the operation of the M6809 processor and 
some other external device. A situation where this 
might be necessary is when data are being transferred 
from some fast I/O device, like a disk, to memory. 

When a SYNC instruction is encountered, the 
processor enters a wait-for-interrupt loop which is 
called the 'syncing state ' . If a hardware interrupt 
occurs and is not masked, the appropriate interrupt 
service routine is activated but the processor 
registers are not stacked. 

If the interrupt is masked and the processor is in 
the syncing state, the effect of the interrupt is to 
cause the wait-for-interrupt loop to terminate. 
However, rather than cause a transfer of control to an 
interrupt service routine, execution continues with the 
instruction following SYNC. Thus processor and 

peripheral operation are synchronised by the interrupt. 

Note that the programmer must explicitly set and 
clear the interrupt mask bits CC.I and CC.F by using 
ANDCC and ORCC instructions. 

8.1.2 Dragon-specific interrupts 

In the above section we explained that the M6809 system 
assumed interrupt vectors lying between addresses FFF2 
and FFFF. In actual fact, the Dragon 's address 
decoder (the SAM chip) maps these addresses onto 
alternative interrupt vectors in locations BFF2 to 
BFFF. This means that the interrupt vectors are in the 
BASIC read-only memory area and that their contents 
cannot be altered by the user. 

As a result, these locations do not contain the 



Vector 


Contents 


BFF2 : 3 


$0100 


BFF4 : 5 


$0103 


BFF6:1 


$010F 


BFF8 : 9 


$010C 


BFFA:B 


$0106 


BFFC:D 


$0109 


BFFE:F 


$B3B4 
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address of the interrupt service routine but contain 
the address of a secondary interrupt vector in RAM 
which should be set up with a jump to the address of 
the interrupt service routine. There is one exception 
to this. The RESET interrupt which is issued when the 
machine is switched on must, obviously, have a service 
routine in ROM. Its address is stored in the RESET 
interrupt vect or . 

The table below shows the how the interrupt vectors 
are assigned. 

Use 
SWI3 secondary vector 
SWI2 secondary vector 
FIRQ secondary vector 
IRQ secondary vector 
SWI secondary vector 
NMI secondary vector 
RESET service routine 

The Dragon does not use all the M6809's interrupts but 
only makes use of the IRQ and FIRQ interrupts. 
Therefore, their secondary interrupt vectors are set up 
with a jump to their service routines, namely JMP $9D93 
and JMP $B469 respectively. All the other secondary 
interrupt vectors are set to and must be initialised 
by the user if required. 

8.2 INPUT/OUTPUT PROGRAMING TECHNIQUES 

In memory-mapped input/output, described in Chapter 2, 
all I/O devices appear to the programmer as memory 
locations called I/O ports. Although memory-mapped I/O 
devices must communicate over the same bus structure as 
memory devices, it is not normally possible or 
desirable to connect a physical device directly to the 
computer's bus structure. Instead, a device interface 
is used to control the peripheral device according to 
commands from the CPU and to isolate that device from 
the bus structure. The interface may also convert data 
into whatever format is required by the physical device 
and vice versa. 

However, unlike normal RAM memory where a read 
returns the last value written to a location, read and 
write operations to a particular I/O port address may 
be completely independent . In other words, an input 
port can occupy the same address as an output port and 
which one is selected is dependent on whether the 
operation is a read or a write. 

Most device interfaces that have been designed for 
microprocessor use are 'programmable ' thereby allowing 
them to be used in a variety of applications. A typical 
example of such an interface is the PIA (Peripheral 
Interface Adaptor) which is explained in detail in the 
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following section. This device has a number of built- 
in registers corresponding to addressed locations which 
can be accessed by the programmer. By writing the 
appropriate bit patterns into these registers, the 
programmer can configure the device in a variety of 
ways. In addition to these control registers, such an 
interface contains a status register which can be read 
by the I/O program to determine the state of the 
device; for example, 'is the data ready', 'can I send 
data now', etc. 

Given the programming model of a peripheral device 's 
interface, the programmer is faced with the problem of 
what technique to use to transfer data across that 
interface under program control. In this section we 
describe three I/O programming techniques 
unconditional I/O transfer, polled or conditional I/O 
transfer and interrupt-driven I/O transfer . 

8.2.1 Unconditional I/O transfer 

This is the simplest method of I/O transfer where the 
programmer always works on the assumption that the 
peripheral controller handling the I/O is always ready 
for output and always has up-to-date input information 
available. Data to be input or output can therefore be 
read from or written to the device at any time. 

This, however, can lead to problems unless the exact 
timing of the I/O process is known. If a request is 
made for input before the peripheral controller has 
received that input from the peripheral device, the 
information returned will probably be that input in the 
previous operation. Similarly, if output is sent 
before the device has completed its previous operation, 
information may be lost. 

As a result of these timing problems, this I/O 
programming technique is not advised unless the 
programmer is forced into it by primitive I/O devices 
which have no means of communicating their status to 
the processor. 

8.2.2 Polled I/O transfer 

This is a widely used I/O programming technique which 
involves a program polling the status of a device 
periodically. When the controller status indicates 
that input is available or that the device is ready for 
output, the I/O transfer takes place. Because the 
transfer is conditional on the controller status bits, 
this method of I/O programming is sometimes called 
conditional transfer. 

In some cases the status bits of the peripheral 
controller are continually examined and the program 
waits for the I/O device to become available. In other 
cases, the status bits are examined at periodic 
intervals of, say, a millisecond. The program must 
ensure that the intervals between checks are not so 
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long that information is lost in the intervening 
period. 

The following fragment of BASIC program illustrates 
this I/O programming technique by polling the button on 
a joystick to see whether or not it has been pressed. 

100 BS = PEEK(&HFFOO) ' BS = button state 

110 IF (BS AND 1) = THEN 100 'Wait for press 

120 'Button pushed so deal with it here 

The drawback of simply looping indefinitely until the 
button is pushed lies in the fact that it is necessary 
to 'busy wait ' for the peripheral to become available . 
This time is completely wasted as no useful work can be 
done until the I/O transfer is complete. In our 
example, the program will 'hang' until the right 
joystick button is pressed. 

In some situations this may be acceptable but it can 
cause problems in situations where several I/O devices 
have to be serviced. For example, say a two-player game 
involves movement and firing, both controlled by 
joystick. It would be impossible for one player to 
move until the other fired thus making evasion very 
difficult indeed! 

However, the program can be modified to cope with 
this situation. Rather than looping indefinitely until 
an event occurs, the program can check the status bits 
of each device in turn. This is illustrated in the 
program below. 

100 BS = PEEK(SHFFOO) 

110 IF(BS AND 1) = THEN 140 

120 ' Deal with right button 

130 GOTO 100 ' Look at buttons again 

140 IF(BS AND 2) = THEN 100 

150 ' Deal with left button 

160 GOTO 100 

However, the player with the left joystick still has a 
problem as the right joystick button always takes 
priority. It is polled first and, if it is held down, 
the left button is ignored. The solution to this 
particular problem is to poll the devices in a round- 
robin manner where the program establishes a polling 
order. The program polls each device in that order 

then cycles back to the beginning of the order. Our 
previous example can be converted to this form by 
removing line 130. 

8.2.3 Interrupt-driven I/O transfer 

We have already introduced the idea of an interrupt and 
suggested that they are very useful in I/O programming. 
In fact, the use of interrupt allows a programming 
technique to be devised which eliminates the need for a 
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'busy wait ' or, indeed, any kind of polling system. 

The disadvantage of the conditional transfer method 
of I/O programming is the fact that the processor 
cannot do useful work whilst it is waiting for a device 
to become ready for I/O. A more satisfactory technique 
is to have the device inform the processor when it is 
ready thus eliminating the need for the processor to 
check the device's status at periodic intervals. The 
sequence of events that occurs upon an interrupt has 
already been explained in the previous section and we 
shall not repeat them here. 

Interrupt-driven transfers can be used as an I/O 
programming technique if the peripheral control 
register has the following facilities: 

(1) An interrupt enable/disable bit which allows the 
programmer to switch interrupts off and on. 

(2) An interrupt status bit which allows the service 
routine to find out which device has initiated 
the interrupt. 

As it is common practice to connect a number of 
peripheral devices to the same interrupt line, the 
interrupt service routine must poll each of these 
devices to see which one caused the interrupt . Once the 
interrupt service routine has identified which 
device/condition is responsible, the condition is dealt 
with by normal instructions on an I/O port . 

The service routine must also make sure that dealing 
with the condition includes removing the cause of the 
interrupt request otherwise, as soon as interrupts are 
enabled again, that same condition will cause another 
interrupt. The service routine will still, presumably, 
fail to remove the condition causing the interrupt and 
thus the system will hang indefinitely. 

If you want to incorporate interrupts into a program 
you must carry out the following steps. 

(1) Write a suitable interrupt service routine. 

(2) Set up the appropriate interrupt vector with a 
reference to that routine. 

(3) Configure the device/interface for interrupts. 

(4) Enable (switch on) processor interrupts. 

It is very important the steps 1 and 2 above be carried 
out before steps 3 and 4 and equally important that 
interrupts should be disabled whilst any changes to the 
interrupt system are being made. If this is not done 
and an interrupt occurs while the service routine is 
being changed unpredictable consequences can ensue when 



157 

the Interrupt is processed. 

To illustrate interrupt processing, we describe how 
to make amendments to the existing Dragon interrupt 
system. 

The normal interrupt (IRQ) is derived from the video 
circuitry which provides an interrupt request every 20 
milliseconds, that is, in correspondence with every 
cycle of the mains frequency. This will be slightly 
different in countries where the mains frequency is 
60Hz rather than 50Hz. The role played by this 
interrupt is to update the system clock which is used 
by the BASIC function TIMER as well as the functions 
SOUND and PLAY. As we saw earlier, the IRQ vectors 
through a secondary vector at addresses $010C, $010D, 
and $010E which normally contain a jump to the clock 
update service routine at address $9D3D. Our example 
replaces the existing interrupt service routine with 
one that manipulates the text character in the top left 
hand corner of the screen. This manipulation is 

carried out as follows: 

ADDCH LDA $400 ; Pick up character at top left 
INCA ; alter it by adding one 

STA $400 ; and return it to its place 

To use this as an interrupt service routine, we must 
provide an IRQ vector set up routine. An example of 
this is: : 

IRQSET ORCC #$10 ; Disable IRQ 

LDX #ADDCH ; Set up entry address 

STX $10D ; and store into IRQSV 

ANDCC #$EF ; Enable IRQ 
RTS 

The new service routine also has to be augmented by the 
code that removes the interrupt request. In this case, 
the interrupt request may be removed with a read 
operation to PIAO ' s peripheral data register which is 
mapped through address $FFOO. We also have to add an 
RTI instruction so that the interrupted process may be 
restarted after the character has been altered. 

We have excluded a check to see what device is 
causing the interrupt since there is normally only one 
IRQing device on the Dragon. We have also omitted the 
code that configures /enables the device interface as 
this required detailed knowledge of the PIA which will 
not be described until later in this chapter. However, 
it is configured by the system as part of the 
initialisation sequence when the machine is switched 
on. 

The final version of the new service routine is 
therefore : 
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* IRQSET - set up interrupt vector 
* 

* Must be called to install new service routine 
* 

IRQSET ORCC #$10 ; Disable IRQ and put entry 

LDX #ADDCH / address of new service 

* routine 

STX $010D ; in secondary IRQ vector 

ANDCC #$EF ; Enable IRQ 

RTS 

* Interrupt service routine 



ADDCH LDA $FFOO 

LDA $400 
INCA 

STA $400 
RTI 



Clear interrupt condition 

Pick up LH corner 

Alter it 

And put it back 

Return from interrupt 



Once the interrupt vector has been set up and IRQ 
interrupts enabled you should see the top left hand 
character cycle through the 256 character set of the 
Dragon at the rate of 50 characters /second. 

You will now find that the TIMER, PLAY, and SOUND 
functions will not work properly. We leave it as an 
exercise to the reader to add the above code to the 
existing service routine so that the clock is updated 
and a character is updated on the screen. 

8.3 THE PERIPHERAL INTERFACE ADAPTOR - PIA 

The peripheral interface adaptors or PIAs which act as 
the Dragon's I/O interfaces are multi-purpose 
peripheral controllers . We saw in the previous chapter 
how one of these PIAs played an essential role in the 
graphics display hardware where it is used to set up 
the video display generator. This section is an 
overview of the functions of a PIA but, for those 
readers who require further information, a full 
technical description of the PIA chip is provided in 
Appendix 4 . 

The function of a PIA is to interface a member of 
the M6800 processor family (in this case, the M6809) to 
various peripherals and, to do so, it provides various 
peripheral data input/output lines as well as 
peripheral control/interrupt lines. Each PIA has two 
8-bit peripheral data buses and four control lines thus 
giving a total of 20 lines which can be used to control 
and interface peripheral devices. 

The flexibility of the PIA is derived from the fact 
that it is a 'programmable' device. This does not mean 
that it can execute machine code instructions but 
rather that the PIA is not dedicated to a specific 
peripheral type. It contains various internal registers 
which can be manipulated by the assembly language 
programmer to configure the PIA to a particular mode of 
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operation. Each of the peripheral data lines can be 
configured to act as an input or as an output and each 
of the control/interrupt lines may be set up in one of 
several control modes. 

A PIA is functionally split into two, independent 
sides called the Aside and the B-side. Each side is 
configured and controlled by three internal 8-bit 
registers. These are: 

(1) The control register (CR) 

(2) The data direction register (DDR) 

(3) The peripheral data register (PDR) 

Effectively, therefore, we have four programmable 
input/output interfaces which may be used separately or 
together. Figure 8.2 is a schematic representation of 
this system. 
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Fig. 8.2 PIA organisation 



The control register is used to configure/control the 
four peripheral control lines which are named CA1, CA2, 
CB1, and CB2 . It also allows the assembly language 
programmer to enable and disable the interrupt lines 
IRQA and IRQB and to monitor the status of the 
interrupt flags IRQA1, IRQA2, IRQB1, and IRQB2 . A full 
description of the functions of this register is 
provided in the PIA Data Sheet (Appendix 4) . 

There is one bit in the control register which is 
not used in the configuration of the peripheral 
control/interrupt lines. This is the data direction 
access bit which is used to select between the data 
direction register and the peripheral data register. 
The reason for this is that the PIA only responds to 
four unique addresses and, as the programmer always 
needs access to the control registers, the other two 
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addresses must be shared by the data direction register 
and the peripheral data register. 

The data direction register (DDR) Is used to control 
the direction of data through each corresponding 
peripheral data line of the peripheral data register. 
If a DDR bit Is 0, this means that the corresponding 
peripheral data line Is an Input whereas If the DDR bit 
Is 1, the associated data line Is an output line. 

Therefore, each peripheral data register may have 
any combination of Input and output lines thus 
providing a good deal of flexibility when Interfacing 
the PIA to external devices. However, It Is the 
responsibility of the programmer to keep track of which 
lines are Inputs and which lines are outputs and to 
make sure that when outputs are updated, other, 
Independent outputs are not affected. 

The data direction register and the peripheral data 
register share an address and the particular register 
addressed depends on the setting of the data direction 
access bit In the control register. This sharing does 
not usually cause problems as typical usage Involves 
setting up the data direction register and then 
accessing the peripheral data register without further 
changes to the DDR. 

The peripheral data register Is used to transfer 
data to and from peripheral devices. Each of the 
peripheral data lines can be configured as an Input or 
as an output as described above. When a line Is 
configured as an output, It will go HI when the 
corresponding bit In the PDR Is set to 1 and will go LO 
when the corresponding bit Is cleared In the PDR. In 
general, after an output has been written It can be 
read back although this Is dependent on the loading of 
the line (see Appendix 4) . 

When a line Is configured as an Input, the data on 
the peripheral data line appears directly on the 
corresponding M6809 data line during a read operation. 
As output line states are also read back, the 
programmer has to explicitly mask them out when the PDR 
Is accessed. 

8.3.1 The Dragon's PIAs 

The Dragon ' s I/O subsystem makes use of two PIAs named 
PIAO and PIA1 . This means that there are 40 peripheral 
data/control lines but, as some devices share lines, 
more than 40 lines can actually be supported. Each PIA 
responds to four unique addresses with PIAO associated 
with addresses FFOO to FF03 and PIA1 associated with 
addresses FF20 to FF23. 

These address ranges can be further subdivided Into 
the Individual addresses of the registers within the 
PIA. In the examples In this chapter, we shall make 
use of these addresses and shall refer to them using 
the symbolic names defined In the table below. 



* Equates for PIA 
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* A- side registers 


PODDRA 


EQU 


$FFOO 


POPDRA 


EQU 


PODDRA 


POCRA 


EQU 


$FF01 


* B-side 


registers 


PODDRB 


EQU 


$FF02 


POPDRB 


EQU 


PODDRB 


POCRB 
* 


EQU 


$FF03 


* Equates for PIA1 


* Aside 


registers 


P1DDRA 


EQU 


$FF20 


P1PDRA 


EQU 


P1DDRA 


P1CRA 


EQU 


$FF21 


* B-side 


registers 


P1DDRB 


EQU 


$FF22 


P1PDRB 


EQU 


P1DDRB 


P1CRB 


EQU 


$FF23 



Data direction register 
Peripheral data register 
Control register 

Data direction register 
Peripheral data register 
Control register 



Data direction register 
Peripheral data register 
Control register 

Data direction register 
Peripheral data register 
Control register 

The connections of the Dragon ' s PIA registers to 
specific devices is summarised in Appendix 7. 

8.4 INPUT '/OUTPUT DEVICES 

Apart from the display, which we discussed in the 
previous chapter, the Dragon is equipped with a variety 
of input/output ports to which peripheral devices may 
be connected. Some of these ports, such as the keyboard 
port, are connected to I/O devices which are an 
inherent part of the system. Others, such as the 
printer port and cassette port, are available for the 
user to connect his own peripherals. 

Each I/O port in the system is connected to either 
PIA1 or PIAO so that each PIA is an I/O controller for 
a number of devices. In particular, PIAO is responsible 
for the keyboard, the joystick control, sound source 
selection, the printer port and video synchronisation. 
PIA1 is responsible for printer handshake control, 
sound generation, the cassette port, VDG mode 
selection, D-to-A voltage control, RAM type detection 
and ROM cartridge detection. 

In this section we shall look at how the user may 
access these I/O ports and how to make use of 
peripheral devices connected to these I/O ports. 

8.4.1 Keyboard control 

The Dragon ' s keyboard is of extremely simple design . 
It consists of a number of keyswitches arranged in a 7 
by 8 matrix with the columns of the matrix connected to 
the peripheral data lines of the B-side of PIAO and the 
matrix rows connected to the peripheral data lines on 
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the A-slde of the same PIA. When a key is pressed, this 
causes the row/column position of that key to be 
short-circuited and this change of state can be 
detected by the keyboard control routine. 

The keyboard is connected so that the column 
lines (PB0-PB7) are configured as outputs and the row 
lines (PA0-PA6) are configured as inputs. With this 
setup, a key depression can be detected by outputting a 
to a column line then reading the input lines PAO- 
PA6 . If no key in that column has been pressed, the 
result read back will be 1111111 whereas a key 
depression causes a to be read in one of PA0-PA6 . 

The keyboard scanning routine is activated 
approximately every ten milliseconds and it outputs a 
zero to each of the columns in turn. It immediately 
looks at the inputs PA0-PA6 and, if the result is not 
1111111, it knows that a key has been pressed. The 
keyboard scanner keeps track of which column has an 
associated row input containing a zero and from the 
position of that in PA0-PA6, it can work out which 
key has actually been pressed. 

The actual arrangement of the keys in the matrix is 
shown in the table below. 

PBO PB1 PB2 PB3 PB4 PB5 PB6 PB1 



PAO 





1 


2 


3 


4 


5 


6 


7 


PA1 


8 


9 


* 


F 


9 


- 





/ 


PA2 


@ 


A 


B 


C 


D 


E 


F 


G 


PA3 


H 


I 


J 


K 


L 


M 


N 





PA4 


P 


Q 


R 


S 


T 


U 


V 


W 


PA5 


X 


Y 


Z 


Up 


Down 


Left 


Right 


Space 


PA6 


ENT 


CLR 


BRK 


N/C 


N/C 


N/C 


N/C 


SHFT 



To illustrate how a key depression can be detected, say 
the user presses the 'U' key. The keyboard scanning 
routine outputs a zero on lines PB0-PB7 and, when a 
zero is output on PB5, an input pattern containing a 
zero will be detected. This zero will be in position 
PA4 thus indicating that 'U' (coordinate PA4/PB5) has 
been pressed. 

In order to keep track of which keys are pressed so 
that it can ignore the same key closure on the next 
scan (remember it scans about 100 times per second) and 
perform key rollover, the keyboard scan routine 
maintains a record of key closures in nine bytes of RAM 
at addresses 151-159 inclusive. 

The first byte (151) records the seven row states, 
that is, it records whether any of the keys in a 
particular row are pressed. When a key in a row is 
pressed, the corresponding bit in location 151 is set 
to 0. Thus, if the 'D' key is pressed, bit B2 in 151 
is cleared to indicate that a key in row 2 has been 
depressed. For other rows, where no key has been 
pressed, the bits in byte 151 are set . 
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The individual bits in 151 are used by the keyboard 
scan routine to determine whether there has been a 
change of state of any of the rows. The value read in 
PA0-PA6 is compared with the value in location 151 and, 
if these values are the same, the keyboard scanner 
assumes that the same key is still held down by the 
user. This is fairly sensible as, when you press a 
key, you are likely to hold it down for more than a 
hundredth of a second. If there has been a change to 
any of the rows, because the user has taken his finger 
off a key perhaps, then the value of location 151 is 
modified to reflect this and a full keyboard scan takes 
place to find out which key has been depressed or 
released. 

This two-stage scanning technique is used to speed 
up the scanning routine although it does mean that key 
rollover does not occur for keys on the same row. In 
other words, holding the 'A' key down and then pressing 
a key on the same row, say ' C , does not register the 
new character but pressing a key on a different row, 
say 'H', does register. 

The remaining 8 bytes 152-159 are used to record the 
state of all the keys in the matrix as each byte 
records the state of the rows for its corresponding 
column. Column state is held in 152, column 1 in 
153, etc. When a key is pressed, then the corresponding 
bit in the column byte is cleared. For example, if 
address 152 contains FE, this indicates that the ' ' 
key has been pressed. 

One drawback of this technique is that it prevents 
the same key from being recognised again unless it is 
released and re-pressed. Furthermore, if a key is held 
down, it prevents other keys in the same matrix row 
from being recognised. This is illustrated by the BASIC 
program below which, at first sight, seems to be able 
to recognise all the arrow keys. 

10 R5 = &H20 'Row 5 's position in column byte 

20 C4 = SH155 'Column 4's byte 

30 C5 = &H156 'Column 5's byte 

40 C6 = $H157 'Column 6's byte 

50 CI = &H158 'Column 7's byte 

60 IF (PEEK(C4) AND R5) = THEN PRINT "UP" 

10 IF (PEEK(C5) AND R5) = THEN PRINT "DOWN" 

80 IF (PEEK(C6) AND R5) = THEN PRINT "LEFT" 

90 IF (PEEK (CI) AND R5) = THEN PRINT "RIGHT" 

100 GOTO 60 

In fact, this program does not recognise more than one 
arrow key being pressed at a time. As the arrow keys 
are on the same row, the keyboard scan routine does not 
do a full scan because the row state byte indicates 
that the row state has not changed. This is perfectly 
reasonable for most normal typing but can be limiting 
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for the game programmer who wishes to provide keys 
which allow simultaneous movement and firing. 

However, it is possible to program around this 
limitation and to force a complete scan of the keyboard 
by setting all bits in byte 151 before each IF 
statement . This can be implemented by including the 
statement POKE &H151, SHFF as statements 55, 65, 75, and 
85 in the above program and changing line 100 to goto 
55. 

This has the effect of fooling the keyboard scanner 
into thinking that all the keys on the row have been 
released and so the next scan will register any keys 
that are down as new closures. Notice that it is 
necessary to poke the value FF to the column state byte 
between every BASIC statement as the keyboard scan 
routine is executed after every BASIC statement and 
sets byte 151 to its old value. Although it works, this 
technique is clumsy and we shall describe a better, 
more elegant technique in Chapter 9 which does not 
involve such program modifications. 

A keyboard auto-repeat facility, where holding a key 
down causes that character to be continuously input, is 
very useful in applications such as games, where keys 
may indicate movement, text preparation, where you 
might want to input strings of the same character and 
screen layout design. 

This facility is not provided on the Dragon because 
a complete keyboard scan is not carried out when a key 
is held down. A complete scan can be forced, however, 
by using a technique comparable to that above and 
poking a value to the individual column bytes. By 
setting a particular column byte, we can force an 
already pressed key to be registered as a new key 
closure . 

The following BASIC program illustrates this 
facility for the INKEY$ function 

10 RB = SH151 ' Row state byte 

20 CB = &H152 ' Column state byte 

30 POKE RB,SHFF : POKE CB, SHFF 

40 A$ = INKEY$ : IF A$ = " " THEN 30 

50 PRINT A$; 

60 GOTO 30 

It is left as an exercise to the reader to predict 
which keys will auto-repeat given the above program and 
to modify the program so that auto-repeat will work 
with all keys. 

It may seem that you could write your own simplified 
keyboard controller in BASIC which directly manipulates 
the PIAs using POKE and PEEK statements . Unfortunately, 
this is not possible because there is no way of 
disabling the keyboard polling routine. If you try to 
control the keyboard yourself from within a BASIC 
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program, you are liable to get Interactions between 
your controller and the standard BASIC polling routine. 
Naturally, you could write your own routine in assembly 
code. 

8.4.2 Printer control 

The Dragon 's printer interface is provided so that the 
user may connect his own printer to the system. The 
interface is configured as a so-called Centronics 
interface which means any one of a number of printers 
designed to use this interface type may be connected to 
the Dragon. The user is not restricted to a single 
specialised printer as is the case with some personal 
computer systems. 

Character data is output to the printer over eight 
interface data lines D0-D1 which are connected to 
POPDRB's peripheral data lines. These PIA peripheral 
data lines are also used by the keyboard column lines 
but, in practice, this does not cause problems. When 
characters are being printed, the I/O system knows that 
the keyboard should not be scanned and vice-versa. 

There are also a number of control (handshake) lines 
which coordinate data transfer to the printer. These 
are called 'printer strobe ' , 'printer busy ' , and 
'printer acknowledge ' . Although the Dragon hardware 
supports all three of these control lines only two of 
them (strobe and busy) are used by the standard Dragon 
software . 

The printer interface control lines are connected as 
follows : 

(1) The 'printer busy' line is connected to bit of 
PIA1 's B-side peripheral data register 

(P1PDRB/PB0) . This line is set up in the associ- 
ated DDR as an input. 

(2) The 'printer strobe ' line is connected to bit 1 
of PIA1 's Aside peripheral data register 

(P1PDRA/PA1) . This line is configured as an out- 
put . 

(3) The 'acknowledge' line is connected to PIAl's CAI 
interrupt input but this line is not actually 
used by the Dragon's I/O system. Naturally, how- 
ever, you can make use of it if you wish to write 
your own printer control programs. 

The printer interface connections are shown in the 
block diagram of the I/O system (Figure 8.1) which 
shows the interface port pins and their associated 
control/data lines . 

It is fairly straightforward to send characters to 
the printer but appropriate control signals must be 
organised so that a character is not sent before the 
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printer is ready for it. The printer ' s state of 
readiness is indicated using the 'printer busy ' line 
which is HI when the printer cannot accept a character 
for printing and goes LO when the printer is not busy. 
To tell the printer that a character is to be printed, 
that character must be set up on the data lines and the 
'printer strobe ' line must be taken from HI to LO and 
then back to HI again. 

To send a character to the printer, the sequence of 
events is therefore : 

10 IF 'printer busy' THEN GOTO 10 

20 Printer data lines = Character to be printed 

30 Printer strobe = LO ; Printer strobe = HI 

The strobe line is actually buffered through an 
inverting buffer so that a set up in PA1 results in a 
1 on the actual strobe pin and vice-versa. Therefore to 
set the strobe line LO and then HI, you must send 
signals which first set it HI and then LO. 

If you wish to use your own printing routine, you 
must manipulate the PIA using assembler rather than 
BASIC POKE and PEEK statements . The reason for this is 
that the printer and the keyboard share PIA data lines 
and it is not possible to disable BASIC'S keyboard 
polling routine . Therefore, if you try to poke to the 
PIA locations associated with the printer, to get 
direct output say, the keyboard scanner resets the PIA 
and your pokes will have no effect . 

The standard Dragon printer output routine is called 
LPOUT and it can be addressed through location 800F. 
This routine expects register A to contain the 
character code, in ASCII, of the character to be 
printed. 

Because a variety of printers can be attached to the 
Dragon, some of the actions performed by this routine 
are determined by a set of parameters stored in RAM 
locations. The initial values of these parameters are 
set up for the most commonly connected printers but 
they can be modified to configure the routine for other 
printers. Modification involves poking the values for 
your printer to the appropriate location. 

The table below gives the addresses of the RAM 
locations used by the printer routine and briefly 
describes the functions of the information stored at 
these addresses. 

Address Initial value Function 

99 $10 (16) Line printer comma field 

width. This is used by BASIC 
to determine which columns to 
print items separated by a 
comma in a PRINT statement. 
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9B $84 (132) Line printer width, that Is, 

the length of the printed 
line. 

9C $00 (0) The line printer character 

position. LPOUT keeps track 
of the position of the next 
character to be printed by 
updating this byte. 
148 $FF (255) Automatic line feed on buffer 

full . If the line printer 
does not automatically flush 
Its buffer when It Is full 
then setting this byte to 
will cause the routine to 
send an end-of-llne sequence 
to the printer which forces 
the buffer to be flushed. 

14A $01 (1) The number of characters In 

an end-of-llne sequence. The 
end-of-llne characters follow 
In succeeding locations from 
14B to 150. Thus there may 
be a maximum of 6 characters 
In an end-of-llne sequence. 

14B $0D (13) Carriage return (CR) code 

(normal EOL sequence) 

14C $0A (10) Line feed (LF) code. If the 

printer needs a CRLF end-of- 
llne sequence, 14A should be 
set to 2. 

As an example of how the line printer routine may be 
reconfigured, the following BASIC direct statements set 
up the printer width to be the same as the Dragon ' s 
display width. 

POKE $H148,0 
POKE &H9B,32 
LLIST 

The routine LPOUT carries out a number of 
'housekeeping' duties such as forcing end-of-llne 
sequences, outputtlng extra spaces to cause line feeds, 
etc. Sometimes, you don't really want this to happen 
but all you really want Is a routine which simply pumps 
characters to the printer. If this Is what you need, 
there Is a no-frllls printer output routine called 
TXLPCH with entry point at location BCF5 . Again, this 
routine expects register A to contain the character to 
be printed. 

8.4.3 Sound control 

In common with many other modern personal computers , 

the Dragon Is equipped with facilities for sound 
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generation. In this respect, personal computers differ 
from larger, professional machines and, unlike graphics 
say, the creative use of sound in human/ computer 
interaction is a largely unexplored area. At the 
moment, the sound generation system is mostly used to 
provide sound effects for games but it seems likely 
that applications for sound generation will be 
discovered in many other areas of computer usage. 

There are four possible sound sources in the Dragon. 
These are: 

(1) From the 6-bit digital to analogue converter. 

(2) From the cassette unit. 

(3) From the cartridge port. 

(4) From PB1 of P1PDRB. 

The first three of these sound sources above are 
analogue sources which means that they generate a 
varying voltage level which is converted to sound. The 
PIA bit, on the other hand, is a binary sound source 
which generates either a HI or a LO pulse. Sound output 
is channelled to the television ' s speaker by modulating 
the sound signal with the video signal that is fed to 
the aerial (antenna) input of the user's television 
set. 

The analogue sound sources are connected to the 
inputs of a device called an 'analogue multiplexor ' . 
This is a device which can accept a number of inputs 
and, according to control line settings, switch any one 
of these inputs to its output line. The Dragon's 
analogue multiplexor has four input lines, a single 
output line and three control lines. One of the input 
lines is not used so it is permanently LO. Two of the 
control lines are used to select which sound source is 
to be routed to the output line with the third control 
line used to enable and disable the multiplexor output. 
This output must be disabled if a binary sound pulse 
generated from the PIA is to be used as the input to 
the sound generator. 

The multiplexor control lines are connected to PIA 
control lines. The lines used are PIA1-CB2 which is 
connected to the output enable/disable multiplexor 
control line and PIA0-CB2 and PIA0-CA2 which are used 
for sound source selection. The table below shows the 
values which these control lines may take and the 
associated sound selections. 

Sound enable Sound select Sound source 

PIA1-CB2 PIA0-CB2 PIA0-CA2 

1 6-bit DAC 

1 1 Cassette 
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1 
1 




1 
1 
X 



Cartridge 

1 Not used 

X Single bit sound 



To select a sound source, you must output an 
appropriate value to the PIA control lines which are 
connected to the analogue multiplexor . When you do so, 
it is absolutely vital that you preserve the value of 
the other bits in the PIA's control register otherwise 
you are liable to cause all sorts of havoc. An example 
BASIC subroutine which selects the 6-bit DAC sound 
source is shown below. 

2000 ' Select and enable 6-bit DAC sound source 

2010 ' POCRA = &HFF01: POCRB = &HFF03 : P1CRB = &HFF23 

2019 ' Now set PIA0-CA2 LO 

2020 POKE &HFF01, (PEEK (&HFF01) AND &HF7) 

2029 ' Set PIA0-CB2 LO 

2030 POKE &HFF03, (PEEK (&HFF03) AND &HF7) 

2040 POKE &HFF23, (PEEK (&HFF23) OR 8) ' Enable sound 
2050 RETURN 

Rather than write your own routine for sound source 

selection, you can make use of an inbuilt system 

routine which we shall call SNDSEL. This can be called 
via address BD41. Its specification is: 

* SNDSEL - Selects 1 of 4 input lines for analogue MUX 
* 

* Register inputs B - input line number 

* = DAC, 1 = Cassette 

* 2 = Cartridge 

* Registers destroyed U, A,B,CC 

This routine does not enable the output of the 
multiplexor so you must do this as a separate step. 
The routine below will switch it on and select the 
source required by calling SNDSEL. 

* SNDON - Switch on sound output from MUX 



* Register inputs - as SNDSEL 



SNDON PSHS U,A,B 
JSR SNDSEL 
LDA P1CRB 
ORA #8 
STA P1CRB 
PULS U,A,B,PC 



Save registers 

SNDSEL equated elsewhere 

Now enable the 

source by setting 

PIA1-CB2 HI 

Restore and return 



To switch off the sound source, a similar routine is 
required although, obviously, SNDSEL is not called and, 
rather than or 8 into P1CRB, you must and $F7 into that 
register. 
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The 6-bit digital to analogue converter (DAC) is a 
device which takes a 6-bit binary value and converts it 
to an analogue voltage. Such a device is very useful 
as many external devices rely on analogue rather than 
binary signals whereas the M6809, obviously, deals only 
with binary information. As well as being an integral 
part of the sound generation system, the DAC is also 
used in joystick manipulation and in the recording of 
data on cassette. We shall look at these applications 
in later sections of this chapter. 

You don 't have to understand how the DAC works to 
make use of it. Basically, it converts a 6-bit value 
between and 63 to an equivalent voltage in the range 
0.25V to 4.75V. The approximate output voltage 

corresponding to an input signal may be computed 
according to the following formula. 

Output voltage = (Input value * 0.0715) + 0.25V 

The DAC's six input lines are connected to PIPDRA's 
peripheral data lines PA2-PA6. Because the top 6 bits 
of P1PDRA are used to control these input lines, the 
6-bit value to be input to the DAC must be offset by 2 
bit positions before loading it into the PIA's 
register. Furthermore, the bottom 2 PIA bits are used 
for other purposes so their values must be preserved 
before the PIA is set up for DAC input. 

The following assembly code routine accomplishes 
this by shifting the input value then oring it into 
P1PDRA. 

* DACOUT - Output a 6-bit value to DAC 

* Register inputs A - 6 bit value 

DACOUT PSHS A ; Save register 

ASIA ; Move bottom 6 bits 

ASIA ; into top 6 bits 

STA ,-S ; and save until later 

IDA P1PDRA ; Preserve the original 

ANDA #$03 ; bottom 2 bits 

ORA ,S+ ; and or in new value 

STA P1PDRA ; Output to DAC 

PULS A, PC ; Restore and return 

The equivalent BASIC routine is: 

1000 ' BASIC DAC output routine 

1010 ' Input parameter N, 6-bit value 

1020 POKE &HFF20, ( (PEEK(SHFF20) AND 3) OR (N * 4) ) 

1030 RETURN 

The DAC is used to support Extended Color BASIC'S SOUND 
and PLAY commands. To create a sound waveform with this 
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device, suitable values must be sent to it at 
appropriate intervals. The volume of the sound output 
is determined by the magnitude of the values output to 
the DAC and the pitch depends on how often the DAC is 
updated with new waveform values. 

We illustrate this with Program 8.1 which generates 
a very crude approximation of a sine wave. This 
program requires that a DAC sound selector routine be 
available at line 2000 and a routine to send a value N 
to the DAC be available at line 1000. 

10 GOSUB 2000 'Select DAC sound source 

20 FOR V = 1 to 15 ' V = volume 

30 V2 = V*2: V4 = V*4 'V2=mid-volume,V4=max-volume 

40 PRINT "MAX VOLUME = ";V4 

50 TIMER = ' Reset time period 

60 FOR C = 1 to 50 'No. of cycles 

10 N=0: GOSUB 1000 ' Vary the waveform 

80 N=V: GOSUB 1000 ' from min volume 

90 N=V2: GOSUB 1000 ' through mid volume 

100 N=V4: GOSUB 1000 ' to max volume 

110 N=V2: GOSUB 1000 ' and back down 

120 N=V: GOSUB 1000 ' to min volume 

130 NEXT C ' Start next cycle 

140 CP = (TIMER/50) /50 'Cycle period 

150 PRINT "CYCLE PERIOD = ";CP;" OF A SECOND" 

160 NEXT V ' Repeat for next volume setting 

110 END 

Program 8.1 Sound output generation via the DAC 

If you run this program, you should hear a steady but 
ragged note with increasing volume. The print 

statements giving details of the volume and the cycle 
period give an indication of how long it takes to 
update the DAC when using BASIC and the slowness of 
BASIC does limit the upper frequency range. The note 
sounds ragged because the DAC is not producing a 
continuously varying voltage which is necessary to 
produce a pure sine wave. Rather, the voltage steps 
from one value to another and to produce a smoother 
note you would have to include more approximations to a 
sine waveform by reducing the differences in step 
levels. Since this would slow the system down, this 
would also reduce the upper frequency range of the 
sound. 

Because of the restrictions on the upper frequency 
range when programming in BASIC, it is better to use an 
assembly code subroutine for DAC sound generation. 

The input signal from the cassette recorder can also 
be used as a sound source. All that happens in this 
case is that the multiplexor routes the cassette input 
signal directly to the TV loudspeaker so you can play 
back music, commentary or anything else you have 
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recorded on the cassette under the control of a 
program . 

This facility is directly supported in BASIC by the 
AUDIO ON and AUDIO OFF commands which actually switch 
the multiplexor to cassette input. You can use the 
SNDON routine above to perform the equivalent action if 
you are programming in assembly code. 

Similarly, the cartridge ROM port has one of its 
input lines connected to the sound multiplexor and an 
input signal from the cartridge can be switched to the 
loudspeaker. This is a rarely-used facility and if you 
are using the cartridge input port to connect some 
other device to your Dragon (we discuss this later) , we 
do not recommend that you use this sound input because 
the voltage levels for it are unspecified. 

Apart from the DAC, the alternative method of sound 
generation on the Dragon is to use the single bit sound 
source. In this case the sound multiplexor is bypassed 
and must be disabled. The signal from the PIA, which is 
the single bit sound signal, is fed directly onto the 
output line of the multiplexor. Naturally, as this is 
a binary value, the sound generated consists of a train 
of pulses corresponding to the binary input to PB1 of 
the PIA. 

To make use of the single bit sound source, the 
programmer must take the following steps. 

(1) Disable the sound multiplexor output 

(2) Select P1DDRB by clearing bit 2 of P1CRB 

(3) Configure PB1 as an output by setting bit 1 of 
P1DDRB 

(4) Select P1PDRB by setting bit 2 of P1CRB 

We demonstrate this in the following BASIC program 
which shows how single bit sound may be used. 

10 GOSUB 3000 ' Disable MUX output 

20 GOSUB 4000 ' Select single bit sound 

30 TIMER = ' Reset timer 

40 OV = PEEK(&HFF22) ' Save value of P1PDRB 

50 HI = OV OR 2 ' To set PB1 HI 

60 LO = OV AND &HFD ' To set PB1 LO 

70 FOR C = 1 TO 50 

80 POKE &HFF22,HI ' Set PB1 HI 

90 POKE &HFF22,L0 ' and LO 

100 NEXT C 

110 CP = (TIMER/50) /50 ' Cycle period 

120 PRINT "CYCLE PERIOD WAS ";CP;" OF A SECOND" 

130 GOSUB 5000 'Switch off single bit source 

140 END 
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We leave it as an exercise for the reader to write the 
subroutines at lines 3000, 4000 and 5000 which disable 
the multiplexor output and select the single bit sound 
source. It is important to switch off the single bit 
sound as it may interfere with the output when the 
multiplexor is in use. To switch off this sound source, 
P1PDRB-PB1 should be configured as an input rather than 
an output . 

8.4.4 Cassette control 

One of the great advantages of personal computer 
systems is that they can make use of commercially 
available tape cassette recorders and standard cassette 
tapes for input and output . These recorders are 
designed for recording and playing back music or speech 
so are analogue devices. Therefore, to use them for 
data input and output, there must be a way of 
converting a binary output to an analogue signal 
recorded on the tape and vice-versa for inputs from the 
tape. 

The technique used in the Dragon to record programs 
and data on a cassette tape is knows as Frequency Shift 
Keying (FSK) . This technique involves representing 

ones and zeros as different frequencies as they are 
recorded. A LO signal (binary 0) is recorded as a 
single cycle of frequency 1200Hz and a HI signal 
(binary 1) is recorded as a single cycle of frequency 
2400Hz. This means that the effective data transfer 
rate from Dragon to cassette recorder is 1800 
bits/second as, on average, there will be an equal 
number of ones and zeros recorded for a program or data 
file. 

The choice of recording frequencies is not entirely 
arbitrary as the 6-bit DAC, described in section 8.4.3, 
is used to generate the appropriate sine waves of 
1200Hz and 2400Hz, with the signal attenuated to about 
IV before output to the recorder . The choice of 
frequencies is the result of a trade-off between the 
number of approximations required to produce these sine 
waves and the execution speed of the instructions 
needed to update the DAC. 

When a tape is used to store programs or data, it is 
not sufficient simply to dump these on the tape and 
hope that you will be able to read them back at some 
later date. Rather, the information written to the tape 
must be preceded by header information which gives a 
name to the information stored, specifies its type, 
and, perhaps, contains information which allows 
hardware synchronisation. As well as this header, a 
trailer or end-of-file block must also be written 
marking the end of the data or program on the tape. 

All the information on the tape, including the 
initial information and end-of-file information, is 
written out in a sequence of blocks which may store 
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from to 255 information bytes. Each block also 
contains header and trailer information as well as 
actual data. 

The overall tape format assumed by the Dragon splits 
the tape into six logical sections: 

(1) A leader consisting of 128 bytes where each byte 
has the hex value 55. 

(2) A name file block. 

(3) A blank section of tape to allow BASIC time to 
evaluate the name file block. Around 0.5 seconds 
are needed for this. 

(4) Another leader of 128 bytes where each byte has 
the hex value 55. 

(5) One or more data blocks. 

(6) An end-of-file block. 

Namefile, data blocks and end-of-file blocks all share 
the same format with an identification byte used to 
mark the block type. This format is: 

(1) A leader byte - 55 (hex) . 

(2) A synchronisation byte - 3C (hex) . 

(3) A block type byte where 01 means data block, FF 
means end-of-file block and 00 means namefile 
block. 

(4) A block length byte - OO-FF (hex) . 

(5) 0-255 bytes of data. 

(6) A checksum byte which is the sum of all the data 
+ block type + block length. 

(7) A trailer byte - 55 (hex) . 

An end-of-file block has no associated data bytes and a 
namefile block has 15 data bytes giving the name and 
type of the file. These 15 bytes are organised as 
follows : 

(1) An 8-byte program name. 

(2) A 1-byte file type where 00 indicates a BASIC 
file, 01 indicates a data file and 02 a machine 
language file. 
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(3) An ASCII flag byte which indicates if the file is 
recorded as ASCII characters or as binary digits. 

(4) A gap flag byte set to 01 when the tape is writ- 
ten as a contiguous stream of blocks and to FF 
when there are gaps between blocks. When writing 
data to the tape, the associated processing time 
usually means that output is not continuous and 
that the tape is switched off and on between 
blocks. The gaps are the result of this switch- 
ing. 

(5) Two bytes for the start address of a machine 
language program. 

(6) Two bytes for the load address of a machine 
language program. 

The length of the leader on the tape is held as a BASIC 
system variable in locations 90:91 and it is possible 
for the user to modify this length to increase the 
length of the tape leader. By poking a value of 1 to 
address 90, the leader is made 3 times longer and 
poking a value of 2 gives a leader 5 times longer than 
normal . The advantage of this is that it gives the 
cassette recorder's automatic volume control more time 
to stabilise thus reducing the probability of cassette 
I/O errors . 

After a program or data file has been recorded, you 
can verify the tape by using the SKIPF command. This 
reads the tape in exactly the same way as CLOAD/CLOADM 
and reports any errors. It does not, of course, load 
the contents of the tape. 

We do not recommend that you write your own routines 
for cassette input and output. Rather, it is much 
better to use the built-in system routines which have 
been implemented as part of the Extended Color BASIC 
system. This provides routines to turn the cassette on 
and off, to read and write blocks of data to the 
cassette, to read and write single bytes to the 
cassette and to read a single bit from the cassette. 

A specification for each of these routines in the 
form of a header comment is provided below. 

* CASON - turn on cassette motor 
* 

* Register inputs - NONE 

* Registers destroyed - X, A, CC 

* Turns on motor and delays until motor comes up to 

* speed. Delay value is a 16-bit value at location 95 

* with initial value = $DA5C representing 0.5 seconds 

* WRTLDR - Turn on tape for writing 
* 
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* Register inputs - NONE 

* Registers destroyed X, A, CC 

* This routines disables IRQ and FIRQ interrupt lines 

* to avoid interruption of recording then calls CASON. 

* It then outputs a bit sync leader. The number of 

* bytes in the leader is a 16-bit value at address 90. 

* It has default value $0080. 
* 

* CSRDON - turn on tape for reading 
* 

* Register inputs NONE 

* Registers destroyed ALL 

* This routine disables FIRQ 

* and IRQ, calls CASON and uses the bit sync 

* information to synchronise the tape input. 

* CASOFF - turn off cassette 
* 

* Register inputs - NONE 

* Registers destroyed A,CC 

* Re-enables IRQ and FIRQ and turns off cassette motor 
* 

* CBOUT - write byte to cassette 

* Register inputs A - byte to be written 

* Registers destroyed Y, B, CC 

* CBIN - read byte from tape 
* 

* Register inputs - NONE 

* Register output A - byte read from tape 

* Registers destroyed A, B, CC 
* 

* BITIN - read a bit from cassette 
* 

* Register inputs NONE 

* Register outputs - bit read is carry bit, CC.C. 

* Registers destroyed B,CC 

* BLKOUT - Output data block 

* Register inputs NONE 

* Registers destroyed ALL 

* WRTLDR must be called before this routine to get 

* the tape up to speed and to write out tape leader. 

* Input parameters are passed in RAM locations 

* $7C - block type 

* $7D - number of data bytes 

* $7E:7F - address in memory of start of block 

* Interrupts remain disabled on exit from this routine 

* BLKIN - read a block from tape 

* Register inputs NONE 
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* Register outputs CC.Z = if I/O error 

* CC.Z = 1 if no I/O error 

* Registers destroyed ALL except U and Y 

* CSRDON must be called before this routine to get 
the tape up to speed and turn on bit sync. 
Input and output parameters are in RAM locations 
$7E:7F - 16-bit start address of block to be read 
$7C - block type read from tape 
$7D - Number of bytes read from tape 

$81 - Error indicator. No errors=0, Checksum error=l 
Memory error = 2 
On exit, interrupts remain disabled 



The entry points to these routines are held in a direct 
jump table starting at address 8000 and/or in an 
indirect jump table located at address AOOO. The table 
below shows which routine is located at which address. 



Routine Direct jump address 


CASON 


8015 


CASOFF 


8018 


WRTLDR 


801B 


CBOUT 


801E 


CSRDON 


8021 


CBIN 


8024 


BITIN 


8027 


BLKIN 


- 


BLKOUT 


- 



Indirect jump address 

AOOC 
A004 



A006 
A008 



We can illustrate the use of the output routines with 
the following program which writes a data block to the 
cassette. 



CASOFF 


EQU 


$8018 






WRTLDR 


EQU 


$801B 






DBADR 


EQU 


$7E 






BLKTYP 


EQU 


$7C 






DBLEN 


EQU 


$7D 






BLKOUT 


EQU 


$A008 








LDX 


#BLOCK 


f 


Set up address of 




STX 


DBADR 


f 


data block 




LDA 


#$01 


t 


File type = DATA 




STA 


BLKTYP 








LDA 


#255 


f 


Number of bytes 




STA 


DBLEN 


t 


is set up 




JSR 


WRTLDR 


r 


Prior to writing tape 




JSR 


(BLKOUT) 


t 


Write block 




JSR 


CASOFF 


r 


Switch off tape 



An input program which reads blocks from the tape and 
displays their contents on the screen is shown below. 
Assume that the equates in the above program have been 
made. 
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CSRDON 


EQU $8021 




BLKERR 


EQU $81 




BLKIN 


EQU $A006 






LDX #$400 


r 




STX DBADR 


f 


NXTFIL 


JSR CRDON 


f 


NXTBLK 


JSR (BLKIN) 






BNE BINERR 


t 




LDA #$FF 


f 




CMPA BLKTYP 






BNE NXTBLK 


f 


* 


BRA NXTFIL 


r 


BINERR 


JSR CASOFF 
RTS 


I 



Screen RAM 

as block copy area 

Turn on tape for reading 

Read a block 

Abort on error 

Check for end of file 

Not eof, get next block 
Otherwise, re-sync and get 
next file 



These routines have shown how blocks of data can be 
read from and written to a cassette and the CASON and 
CASOFF routines are generally used in this context . 
However, there may be circumstances where you wish to 
avoid using these routines as they both manipulate the 
interrupt mask bits in the condition code register. 

The relay used to control the cassette motor is 
connected to the CA2 control line output of PIA1 and 
you can switch the cassette motor on and off by setting 
and clearing this bit. To switch on, the bit should be 
set HI; to switch off, the bit should be cleared to LO. 
This can be accomplished with the following BASIC 
statement . 

POKE &HFF21, (PEEK(&HFF21) OR 8) ' Switch on 
POKE &HFF21, (PEEK(&HFF21) AND &HF7) 'Switch off 

8.4.5 Joystick control 

For game playing, where continuous movement is 
required, typing different keys is not really the most 
convenient way of specifying that movement . The 
Dragon ' s designers have provided an input port which 
can be used to connect joysticks to the system. These 
joysticks can be moved in the X-Y plane to control 
movement and have a button input for firing. Each 
joystick has two potentiometers associated with it 
whose output voltage is related to the X and Y 
coordinates of the stick. These voltages can be 
detected and their variations related to the movement 
of a symbol on the screen . 

The easiest way to read joystick values is to make 
use of Extended Color BASIC'S JOYSTK command. This 
command is a BASIC function which takes as a parameter 
the axis number of a joystick and returns a numeric 
value in the range 0-63 which represents the position 
of that axis. The actual axes specified by JOYSTK are: 



(1) JOYSTK (O) reads right joystick, X-axis (horizon- 
tal) 
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(2) JOYSTK(l) reads right joystick, Y-axis (vertical) 

(3) J0YSTK(2) reads left joystick, X-axis (horizon- 
tal) 

(4) J0YSTK(3) reads left joystick, Y-axis (vertical) 

The arrangement of the axes potentiometers is such that 
they return values relating to the screen graphics 
coordinate convention of the top left corner being 0,0. 
Therefore, reading the right joystick at the extreme 
top left of its travel will result in JOYSTK (0) = and 
JOYSTK(l) = and, at the extreme bottom right, the 
readings will each be 63. In fact, these values may 
vary slightly because of slight differences in the 
potentiometers built into the joysticks. 

A feature of the JOYSTK function is that new 
joystick readings are only taken when JOYSTK (O) is 
used. This means that JOYSTK (O) must be used before 
other JOYSTK commands even if JOYSTK (2) and JOYSTK (3) 
are the only values used in the program. 

The reason for this becomes clear when we consider 
how the JOYSTK function is implemented. It actually 
calls a system routine called JOYIN which reads all the 
joystick values and this routine is only activated when 
JOYSTK (O) is used. When other JOYSTK parameters are 
used, the value returned is simply that which was read 
by the previous activation of JOYIN. 

JOYIN can be used by the assembly language 
programmer. It may be accessed through the direct I/O 
jump table at location 8012 or through the indirect 
jump table via location AOOA. Its specification for 
the assembly language programmer is as follows: 

* JOYIN - read joystick values 
* 

* Register inputs NONE 

* Registers destroyed ALL 

* JOYIN returns a value in the range 0-63 for each 

* of the joystick potentiometers . 

* These values are returned in RAM 

* locations as follows 

* $15A - X-coordinate of right joystick 

* $15B - Y-coordinate of right joystick 

* $15C - X-coordinate of left joystick 

* $15D - Y-coordinate of left joystick 

The buttons on each joystick are arranged so that, when 
they are pressed, they ground an input line. These 
button outputs are connected to PAO (right button) and 
PA1 (left button) of POPDRA. The following BASIC code 
demonstrates how button pushes may be detected. 

10 FO = PEEK(SHFFOO) AND 1 ' Read PAO button state 
20 Fl = PEEK(SHFFOO) AND 2 ' Read PA1 button state 
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30 IF FO = THEN PRINT "FIRE1 " 
40 IF Fl = THEN PRINT "FIRE2" 
50 GOTO 10 

As these button outputs are shared with the first two 
rows of the keyboard matrix, the standard keyboard 
scanning routine must make sure that spurious 
characters are not generated due to the 
misinterpretation of button closures as key closures. 
Unfortunately, the only reliable way to do this Is to 
disable the keyboard completely so, even If you write 
your own keyboard scanner, you should not try to use 
the keyboard and joysticks at the same time. 

If you use joysticks, we advise you to use the JOYIN 
routine but for those readers who wish to write their 
own joystick routines, we now describe, very briefly, 
how an analogue voltage Input from the joystick Is 
converted to a value between and 63. 

Each of the four joystick potentiometers produces a 
voltage between OV and 5V depending on the position of 
the joystick. The technique used to convert this to a 
digital value Involves Inputting a known value to the 
DAC (described above) and then comparing the DAC output 
with the potentiometer value. If they are 

approximately the same, the DAC Input Is taken as the 
digital representation of the potentiometer output 
voltage. If the values are not the same, the DAC Input 
value Is varied until the values match. 

This simple analogue to digital conversion system 
actually has three components. These are the DAC, an 
analogue multiplexor which can select one of the 
potentiometer, and a voltage comparator to compare the 
DAC and multiplexor outputs. The comparator output Is 
connected to PA7 of POPDRA. If the output from the 
multiplexor exceeds the DAC output, the comparator 
output Is HI and If the DAC output Is greater, the 
comparator output Is LO. 

In performing the conversion, a value at the halfway 
point In the DAC range, namely 32, Is written to the 
DAC and the resulting output voltage compared with the 
multiplexor output . If the DAC voltage Is higher than 
the multiplexor output, a new DAC Input value which Is 
half the old value Is tried. If the DAC output Is 
lower than the multiplexor output, a new DAC value 
which Is half as much again as the current value Is 
attempted. This process continues until a DAC output 
which Is approximately equal to the multiplexor output 
results. 

This technique Is called binary search and Is often 
used when values have to be compared. It Is an 
efficient searching technique which has applications In 
many different kinds of program. The table below 
summarises the approximations resulting from this 
binary search. 
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Range 


DAC 


DAC 


Joystick 


Comparator 


New range 




Value 


Voltage 


Voltage 


POPDRA- 


-PA7 




0-63 


32 


2.53 


3.5 


1 




32-63 


32-63 


48 


3.69 


3.5 







32-48 


32-48 


40 


3.11 


3.5 


1 




40-48 


10-48 


44 


3.40 


3.5 


1 




44-48 


14-48 


46 


3.54 


3.5 







44-46 


14-46 


45 


3.47 


3.5 


1 




45-45 



The four joystick input lines are connected to the 
analogue multiplexor in exactly the same way as the 
multiplexor connection used for the sound source. The 
same PIA lines are used for this connection so the 
sound selection routine described above may be used for 
joystick selection. The association of PIA bit values 
and joystick source is as follows: 

Joystick select 

PIA0-CB2 PIA0-CA2 

Right - X-axis 

1 Right - Y-axis 

1 Left - X-axis 
1 1 Left - Y-axis 

8.4.6 The cartridge expansion port 

The final section in this chapter is devoted to a -very 
brief description of the cartridge/expansion port 
fitted to the Dragon. This port is intended for a 
plug-in cartridge containing ROM-based software but the 
40-pin connector does provide access to most of the 
M6809's bus signals. This means that other devices can 
be interfaced to the Dragon via this expansion port. 
It is beyond the scope of this section to discuss such 
interfacing and the interested reader is referred to 
one of the books on this topic listed in the reading 
list. 

The minimum information required to make interfacing 
possible is a description of the signals available at 
the expansion port connector. These are summarised in 
the table below. Some of the signal names are suffixed 
with an asterisk, indicating that these are 'active 
low' signals, meaning that they must go LO (0 volts) 
for action. 

Description 
+12V Power supply connection 
As above 

Connected to HALT input of M6809 
Non-maskable interrupt input to 
M6809 

Main reset /power-up signal 
Main M6809 clock 
Quadrature clock, 
leads E by 90 degrees 



Pin No. 


Use 


1 


+ 12V 


2 


+ 12V 


3 


HALT* 


4 


NMI* 


5 


RESET* 


6 


E 


7 


Q 



9 


+5V 


10-17 


D0-D7 


18 


R/W* 


19-31 


A0-A12 


32 


CTS* 


33 


GND 


34 


GND 


35 


SND 


36 


P2* 


37-39 


A13-A15 


40 


DSD* 
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8 CART Interrupt input for cartridge 

detection 

+5V power supply connection 
Pins 10-17 are connected to the 
M6809's data lines 
M6809 Read/Write signal 
Pins 19-31 and 37-39 are connected 
to the M6809's address lines 
Cartridge select signal 
Signal ground 
Signal ground 
Sound input 
PIA2 address select 
Top three address lines 
Device selection disable interrupt 

The signals supplied by the expansion port fall into 
one of four categories: 

(1) Power supply 

(2) M6809 bus signals 

(3) Device select signals 

(4) Cartridge I/O signals 

The Dragon power supply provides +5V and +12V and these 
can be used to power the cartridge components. 
However, you must be careful when using these as there 
is not a great deal of spare power available. 

The M6809 bus signals (D0-D7 , A0-A15, R/W*, RESET*, 
NMI*, HALT*, E and Q) are fully described in Appendix 1 
and the device select signals are described in Appendix 
2. The function of the other signals is summarised 
below. 

(1) CTS* 

The expansion port occupies the address space 
between COOO and FEFF inclusive. This line is 
pulled LO by the SAM address decode logic whenev- 
er an address in this range is specified. 

(2) P2* 

There is provision in the address decode logic 
for a third device select signal similar to the 
ones that select PIAO and PIA1 . P2 * goes LO 
whenever an address is specified in the range 
FF40-FF5F . 

(3) DSD* 

When this signal is pulled LO by suitable car- 
tridge circuitry, it disables the Dragon ' s inter- 
nal device select logic. This has the effect of 
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switching off those devices which are normally 
selected and, as a result, their address space 
may be used by the cartridge hardware. This 
avoids contention problems which can arise when 
two or more devices are activated and try to 
place data on the data bus at the same time. 

(4) CART 

This signal is tied to the CB1 interrupt input 
pin of PIA1 . This can be used for an auto-start 
facility where a clock line (normally Q) is con- 
nected to this line to produce the appropriate 
edge for PIA1 's interrupt logic. This is the nor- 
mal arrangement for games cartridges. 

(5) SND 

This signal is connected to the sound multiplexor 
and allows the cartridge to provide the sound 
source . 



Chapter 9 

Dragon hints and tips 



In a complex system such as the Dragon there are, 
inevitably, many details which cannot be neatly 
packaged under a particular heading. These details are 
often of importance to the programmer who wishes to 
exploit the capabilities of his machine so, in this 
chapter, we present a pot-pourri of Dragon information 
which we hope may be useful to you. We cannot explain 
everything in great detail as this would require a book 
in itself but we do provide enough information to get 
you started with your own experiments. 

In this chapter we describe what happens when you 
switch on your machine, how BASIC programs and data are 
stored, how to pass parameters to assembly code 
programs and how to add new commands to BASIC. We also 
provide tables of BASIC system variables, some of which 
may be altered to tailor the system to your own 
specification . 

9.1 POWER-UP/RESET ACTIONS 

When you switch on your machine a RESET interrupt 
occurs and this causes a transfer to an initialisation 
routine in ROM at address B3B4 . The first thing that 
this routine does is to configure the SAM chip as, 
until this is done, RAM cannot be used. Then the PIAs 
are configured to their default settings which, in 
turn, sets up the VDG and I/O devices. The hardware 
initialisation routine may also be accessed via the 
direct jump table and a jump to this routine is stored 
at location 8000. The routine expects the return 
address to be in register Y as RAM is not available. 

Once the hardware is initialised, a software 
initialisation stage is entered which first sets up a 
temporary stack for subroutine calling. The next step 
is to find out whether this is a 'cold-start ' or a 
'warm-start ' reset and this is determined by the 
contents of the reset flag at address 11 and the 
secondary reset vector at addresses 12 : 13 . If the 
reset flag is $55 and the secondary reset vector points 
to a NOP instruction, a warm-start sequence is 
initiated otherwise a cold-start takes place. 

The software initialisation routine may be accessed 
via the jump table (8003) and has neither input nor 
output parameters. 
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9.1.1 Cold-start initialisation 

When first switched on, the machine's random access 
memory contains random bit patterns as the contents of 
RAM are lost when the power is switched off. 
Therefore, the first action of the cold-start routine 
is to clear RAM to zeros so that system variables, etc. 
have a default value of zero. 

The next step is to clear the text screen and this 
is followed by a RAM-sizing operation which detects the 
top of the useable RAM on the machine. The size of RAM 
can be determined by altering consecutive memory 
locations in turn until an unalterable location is 
detected. This is the start of ROM so the last RAM 
address is the address which immediately precedes this. 

The final step in the software initialisation is to 
set up BASIC'S system variables and these are 
initialised by copying their values from tables in ROM. 

When software initialisation is complete, the reset 
service routine looks for the occurrence of a disk 
controller cartridge by checking if the characters 'DK' 
occupy addresses C000:C001. If a controller is 

present, the disk controller is initialised by jumping 
to an initialisation routine at address C002. 

If there is no disk controller, IRQ and FIRQ 
interrupts are enabled by clearing the appropriate bits 
in the condition code register. This allows an auto- 
starting ROM cartridge to interrupt on FIRQ thereby 
transferring control to the cartridge software. If no 
ROM cartridge is present, the secondary reset vector is 
set to point at the warm-start routine and the reset 
flag set to $55. 

Finally, the BASIC system is initiated and the 
system is ready for use. 

9.1.2 Warm-start initialisation 

The warm-start initialisation routine is invoked on a 
manual reset after the initial powering up of the 
machine. The code in this routine is used to re- 
initialise those variables needed to restart an 
existing program, to clear the text screen and to re- 
enable the PIA and processor interrupts. The user's 
BASIC program is left intact . However, if a BASIC 
program or an injudicious POKE has corrupted some vital 
system variables, then the only course of action left 
to the user is to initiate a cold-start initialisation 
by switching the machine off and on. 

The following BASIC statements show how to perform a 
warm-start from BASIC. 

10 EXEC &HB3B4 'Execute the reset routine 

20 PRINT "WE WON'T GET HERE AS STACK IS RESET" 

When run, the above program will exit and display the 

'OK' prompt but the program will remain intact and can 

be listed, run, etc. However, if the statement POKE 
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&H71,0 is added as line 5, this will force a cold-start 
and the full sign-on message will appear. 

9.2 BASIC PROGRAM STORAGE 

When you type in a BASIC program, the system saves it 
in memory and operates on this saved program when you 
type a RUN command. The format of a saved BASIC 
statement is: 

<linkxline numberxstatement>EOL 

The <link> field is a 16-bit field and holds the 
address of the following line. The <line number) field 
is also 16 bits wide and holds the statement 's number 
as an unsigned 16-bit integer. This is followed by the 
text of the line and the end of the line is marked by 
EOL which is a null byte. The end of a program is 
indicated as two zero bytes. 

The BASIC program below is a dump program which 
scans a stored BASIC program and prints the stored form 
of that program. In its present form, it actually 
prints the stored form of itself but it may readily be 
modified to print out the internal form of another 
BASIC program. 

10 'DUMP PROGRAM 

15 'Peeks a word (16 bits) 

20 DEF FNW (A) =PEEK (A) *25 6+PEEK (A+l ) 

30 DIM ZZ(2) , XX (2,1) ,ZZ$(2) ,XX$ (2,1) 

40 DIM XY (1,2,3) 

50 'DEFINING VARIABLES BEFORE USE 

60 FOR I=OT02 

70 ZZ (I) =1 : ZZ$ (I) =STR$ (I) 

80 FOR J=OT01 

90 XX(I,J)=C: XX$ (I, J) =STR$ (C) 

100 XY(J, I, 0)=C 

110 C=C+1 

120 NEXT J, I 

130 PS=0 'Program Start 

140 PE=0 'Program End 

150 VS=0 'Variables Start 

160 VE=0 'Variables End 

170 AS=0 'Array Start 

180 AE=0 'Array End 

190 DA=0 'Dump Address 

200 NA=0 'Next Address 

210 DV=0 'Device number 

220 DBYTE=0:AN$="" :SBYTE=0 

230 R=0:H3=0:H2=0:H1=0:H0=0 

240 PA=&H19 

250 PS=FNW(PA) '19:1A contain PS address 

260 VS=FNW(PA+2) '1B:1C contain VS address 

270 AS=FNW(PA+4) '1D:1E contain AS address 
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280 PE=VS-1 'Variables are after program 

290 VE=AS-1 'Arrays are after variables 

300 AE=FNW(PA+6)-l '1F:20 holds free space address 

310 CLS 

320 INPUT"OUTPUT TO PRINTER" ;AN$ 

330 IF AN$ = "Y" THEN DV=-2 ELSE DV=0 

340 PRINT#DV, "PROGRAM START ADDRESS = "; :DBYTE=PS 

350 GOSUB 1000:PRINT#DV 

360 PRINTiDV, "PROGRAM END ADDRESS = "; :DBYTE=PE 

310 GOSUB 1000:PRINT#DV 

380 PRINT#DV, "VARIABLE START ADDRESS = "; :DBYTE=VS 

390 GOSUB 1000:PRINT#DV 

400 PRINT#DV, "VARIABLE END ADDRESS = "; :DBYTE=VE 

410 GOSUB 1000:PRINT#DV 

420 PRINT#DV, "ARRAY START ADDRESS = "; :DBYTE=AS 

430 GOSUB 1000:PRINT#DV 

440 PRINT#DV, "ARRAY END ADDRESS = "; :DBYTE=AE 

450 GOSUB 1000:PRINT#DV 

460 INPUT "DO YOU WISH A PROGRAM DUMP";AN$ 

410 IF AN$o"Y" THEN GOTO 630 

480 PRINT#DV, "PROGRAM DUMP" 

490 DA=PS 

500 NA=FNW(DA) 

510 IF (NA=0) OR (DA=PE) THEN GOTO 620 

520 PRINT#DV:PRINT#DV 

530 DBYTE=DA: GOSUB 1000 'PRINT CURRENT ADDRESS 

540 PRINT#DV 

550 DBYTE=NA: GOSUB 1000 'PRINT NEXT ADDRESS 

560 DA=DA+2 

510 DBYTE=FNW(DA) : GOSUB 1000 'PRINT LINE NUMBER 

580 DA=DA+2 

590 SBYTE=PEEK (DA) : GOSUB 2000 'PRINT LINE CONTENTS 

600 DA=DA+1 

610 IF DAoNA THEN GOTO 590 ELSE GOTO 500 

620 PRINT#DV 

630 INPUT "DO YOU WANT A VARIABLE DUMP";AN$ 

640 IF AN$ <> "Y" THEN GOTO 690 

650 PRINT#DV:PRINT#DV:PRINT#DV, "VARIABLE DUMP" 

660 FOR DA = VS TO VE 

610 SBYTE=PEEK (DA) : GOSUB 2000 

680 NEXT DA 

690 PRINT#DV 

100 INPUT "DO YOU WANT AN ARRAY DUMP";AN$ 

110 IF AN$<'>"Y" THEN GOTO 160 

120 PRINT#DV:PRINT#DV:PRINT#DV, "ARRAY DUMP" 

130 FOR DA = AS TO AE 

140 SBYTE=PEEK (DA) : GOSUB 2000 

150 NEXT DA 

160 PRINT#DV:PRINT#DV, "DUMP FINISHED" 

110 STOP 

1000 'PRINT 2 BYTES AS 4 HEX CHARS 

1010 R=DBYTE 

1020 H3=INT(R/4096) : R=DBYTE-H3*4096 

1030 H2=INT (R/256) : R=R-H2*256 
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1040 H1=INT(R/16) : H0=R-H1*16 

1045 HW$=HEX$ (H3) +HEX$ (H2) +HEX$ (HI) +HEX$ (HO) 

1050 PRINT#DV, USING "% %"; HW$ 

1060 RETURN 

2000 'PRINT 1 BYTE AS 2 HEX CHARS 

2010 H1=INT (SBYTE/16) : H0=SBYTE-H1*16 

2020 PRINT#DV, USING "% % "; HEX$ (HI ) +HEX$ (HO) ; 

2030 RETURN 

If you run this program, you will see that the BASIC 
program is actually stored in a semi-compressed form 
with reserved words (DIM, INPUT, PRINT, etc.) 
represented as a single byte or token. This token 
always has its top bit set to distinguish it from 
normal ASCII characters which all lie in the range 0- 
121 . You can see this if you modify the above program 
by printing each byte as an ASCII character rather than 
as a pair of hexadecimal digits. The following 
subroutine may be used to do this: 

2000 ' Print 1 byte as a character 
2010 PRINT CHR$ (SBYTE) ; 
2020 RETURN 

If you now run the dump program with this amendment, 
you will see most of the text as it was originally 
typed into the machine. However, all reserved words 
will have disappeared and will have been replaced by 
Semigraphic characters. 

There are two reasons for storing the program in 
this semi-compressed way: 

(1) Space is saved. Rather than reserved words like 
INPUT taking up 5 bytes, only a single byte is 
required to represent that command. 

(2) Program execution speed is increased. The reason 
for this is that the token representing the 
reserved word is used as an index into a jump 
table of routines to carry out the action speci- 
fied in the command. Therefore, the token 
representing INPUT is a form of indirect address 
to the INPUT routine. 

All tokens representing reserved words have values 
between 128 and 255 because the top bit of the token is 
always set . Unfortunately, Extended Color BASIC has 
more than 127 reserved words, by the time you take the 
names of all system routines into account, so an 
alternative technique is used to encode function names. 
This involves use a 2-byte code for the function 
name where the first byte is always FF. A byte whose 
value is FF means that the following byte is the token 
for a routine and, obviously, the value FF is not 
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itself used as a reserved word token. The table below 
shows some examples of reserved word tokens as single 
and as double bytes. 



Reserved 


word 


Token 


DIM 




$8C 


FOR 




$80 


= 




$CB 


STR$ 




$FF8E 


PEEK 




$FF8C 



The addresses of the routines, called action routines, 
which are used to execute the reserved words are held 
in a table called the dispatch table. This is indexed 
by the reserved word token. A complete list of 
reserved words, associated tokens and dispatch 
addresses is provided in Appendix 7. Obviously, there 
must be separate dispatch tables for the normal 
reserved words and the function reserved words so that 
indices do not clash with each other. 

Reserved words are converted to tokens by the BASIC 
system's input routine which tries to match each input 
character sequence against a reserved word list which 
is a table of reserved words. The token associated with 
each reserved word is taken to be its position in the 
reserved word table plus 80 (hex) to set the top bit. 
Thus the 11th reserved word has token value 91 (hex) , 
the 37th has value A5 (hex), etc. If a match is found, 
the word is replaced by its token. The same table is 
used by the LIST routine which converts tokens into 
reserved words so that the program may be listed. 

The BASIC program statement storage area is 
immediately followed in memory by storage areas devoted 
to simple variables and array variables. Simple 
variables are either numeric or string variables and 
only the first two characters of the variable name are 
used to identify the variable. All others are ignored. 
The variable area is made up of the variable name as a 
pair of ASCII characters followed by a 5-byte 
representation of the number or string. These 

representations are described in section 9.3. 

All names are represented as two characters so 
single character names are made up of the single 
character plus a zero byte. Notice that this does not 
mean that A may be confused with AO as the ASCII 
character ' ' does not have byte value . String type 
variables are distinguished from numeric variables by 
setting the top bit of the last character in the 
variable name. 

Array variables are held in a separate storage area 
and array names are distinguished from simple variable 
names by suffixing a ' ( ' to the name . In the array 
storage area, each array is stored as a structure: 
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<array namexarray descriptorxarray values> 

The array descriptor provides information about the 
size and number of dimensions of the array. It is 
structured as follows: 

(1) Length of array in RAM - 2 bytes. 

(2) The number of array dimensions - 1 byte. 

(3) For each dimension, a list (2 bytes each) of the 
number of elements in that dimension. 

The array values are held as normal string type or 
numeric type values. 

The BASIC system uses a number of variables to keep 
track of the program, variable and array storage areas. 
These are: 

Address Use 

$19:1A Holds address of start of BASIC program 

$1B:1C Holds address of start of simple variables 

$1D:1E Holds address of start of array variables 

$1F:20 Holds address of start of unused memory 

9.3 BASIC'S INFORMATION REPRESENTATION 

When devising any high-level programming language 
system, the system designer must make some very 
fundamental decisions regarding the way in which 
numeric and character variables are represented in his 
system. BASIC is very flexible in this respect, 
allowing variable length character strings and allowing 
numbers to be either real numbers (numbers with a 
fractional part) or integers. 

If you want to interface assembly language with 
BASIC it is useful, although not essential, to have 
some idea of how the BASIC system represents 
information. Such knowledge also helps you to 
understand some of the limitations of BASIC and why 
some applications are particularly slow to execute. In 
this section, therefore, we describe how numbers and 
string variables are represented in BASIC. 

9.3.1 Number representation 

The original designers of BASIC made a very 
important (and, in our view, a correct) decision that 
no distinction should be made between real numbers and 
integers. A BASIC numeric variable may be either a 
real number or an integer and there is no need for the 
programmer to indicate, in advance, the type of the 
variables which he uses. 

In this respect, BASIC differs from almost all other 
programming languages which treat integers and real 
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numbers differently. The reason for this is that 
operations on integers are easier to implement and much 
more efficient than operations on real numbers. If no 
distinction is made between them, the system must 
assume that any number may have a fractional part . As 
a result, integers in BASIC are represented as real 
numbers with a fractional part equal to zero. 

This explains why applications which involve a lot 
of integer arithmetic are relatively slow in BASIC. 
The integer arithmetic involved is actually carried out 
using real number operations and it is not possible to 
take advantage of the M6809 ' s fast integer arithmetic 
facilities. This is one reason why assembly language 
programs which only use integers are so much faster 
than corresponding BASIC programs. 

The representation of real numbers in a computer is 
made up of two parts. These parts are called the 
mantissa, which is the number to be represented held as 
an integer representing a fraction between and 1, and 
the exponent, which is also an integer, representing 
the power to which that fraction is raised in order to 
form the correct real number. 

This is really quite a familiar system. If the 
exponent represents the numbers of powers of 10 to 
which a fraction is to be raised, the table below gives 
some examples of how real numbers might be represented 
using exponent/mantissa notation. 



Real Number 


Exponent 


Mantissa 


5.55555 


1 


. 555555 


.0032 


-2 


.32 


3456789 


7 


.3456789 


234.456 


3 


.234456 



We have explained this representation in terms of 
powers of 10 because that is the number base with which 
we are most familiar. In the BASIC system, however, the 
exponent represents the power of 2 to which the 
exponent is raised. Therefore, in BASIC, the value of a 
number is computed by multiplying the fraction by 2 
raised to the power specified in the exponent. 

Real number in BASIC are represented using 5 bytes. 
These bytes are used as follows: 

Byte (leftmost byte) Exponent 
Bytes 1-4 Mantissa 

The leftmost bit of the mantissa, that is bit 7 of byte 
1, represents the sign of the mantissa. If it is 
this means a positive mantissa, if it is 1 this means 
that the mantissa is negative. The mantissa itself is 
not held as a two's complement number but is 
represented as a positive integer. A mantissa of zero 
means that the number represented is zero. In this 
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case, the exponent part is Ignored by the BASIC system. 

The exponent is held as a positive number between 
and 255 which seems to imply that negative exponents 
cannot be represented. However, to get the actual value 
represented by the exponent, 128 must be subtracted 
from it . Therefore, an exponent of zero means that the 
number represented is raised to the power -128, a 
exponent of 128 means that the number is raised to the 
power and an exponent of 255 means that the number is 
raised to the power 127. 

Given this representational system, the smallest 
number which the BASIC programmer may use is 10.14 to 
the power -38 and the largest number is 10.14 to the 
power 38. In many cases, however, the actual number 
represented is an integer between -32168 and 32767. If 
this is the case, the system function INTCNV can be 
called by the assembly language programmer. This 
function returns the integer value of the BASIC number 
in accumulator D. 

INTCNV is designed to convert a real number to an 
integer. If the number to be converted lies outside 
the range of 16-bit integers, INTCNV causes an overflow 
error and control automatically reverts to the BASIC 
system. Similarly, if a string rather than a number is 
passed as a parameter to INTCNV, a type mismatch error 
is signalled and control reverts to BASIC. 

The routine INTCNV uses a so-called floating-point 
accumulator in memory locations 4F-54 . The floating- 
point accumulator (FAC) gets its name because real 
numbers represented in exponent/mantissa notation are 
sometimes called floating-point numbers. It is a 6-byte 
area organised as follows: 

Byte Exponent of real number 

Bytes 1-4 Mantissa value 
Byte 5 Mantissa sign 

The sign of the mantissa is factored out of the real 
number representation and held as a separate byte on 
its own . The reason for this is that it helps speed up 
internal floating-point computations. As you would 
expect, a byte value of zero means that the mantissa is 
positive and a byte value of FF means that the mantissa 
sign is negative. 

There is no need for the programmer to write code 
which explicitly converts a BASIC numeric variable to 
FAC representation. Rather, there is an in-built 
routine called MOVFM which carries out such a 
conversion. MOVFM uses the system FAC in locations 4F 
onwards and expects the address of a numeric variable 
in the BASIC variable table or anywhere else in memory 
to be in register X. 

A complementary function called GTVABF is used to 
convert an integer held in accumulator D to its 
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floating-point representation in a 6-byte floating 
point accumulator. Again, the system's FAC is assumed 
by this routine. The following example shows an 
assembly code routine which uses INTCNV and GIVABF to 
add 1 to a BASIC numeric variable. 



* Input register X - Address of FAC 

* The value in FAC is incremented by 1 by this routine 

* Registers destroyed D, CC 
* 

ADD1 JSR INTCNV ; Convert to integer 

ADDD #1 ; Add 1 to D 

JSR GIVABF 
RTS 

9.3.2 String representati on 

The BASIC system maintains a string storage area where 
the actual characters making up a string are stored and 
holds string variables as references into this area. 
However, rather than store the string length along with 
the string characters, BASIC holds that length along 
with the address, in the string storage area, of the 
string characters. In fact, each string is represented 
by a 5-byte object called a string descriptor. This is 
structured as follows: 

Byte (leftmost byte) String length 

Byte 1 Housekeeping byte 

Bytes 2-3 String address 

Byte 4 Housekeeping byte 

The parts which we are interested in are bytes 0, 2 and 
3. Bytes 1 and 4 are used by the BASIC system to hold 
information which allows it to perform garbage 
collection in the string storage area as discussed in 
Chapter 6. The techniques used for garbage collection 
are not important here and bytes 1 and 4 should not be 
changed by the assembly language programmer. 

The programmer may write assembly code routines to 
manipulate string descriptors and call these routines 
with a USR call . However, the modification of 
descriptors is a dangerous business as it is possible 
to corrupt other system information which could result 
in inexplicable system failure. As the descriptor holds 
the string length, the only really safe operation is to 
shorten the string by modifying the length byte. On no 
account should you try to lengthen the string or change 
the actual string characters addressed by bytes 2 and 3 
of the descriptor. The only safe operation on the 
address field of the string descriptor is to change it 



234 

to point at some character rather than the first string 
character. You must, naturally, also change the string 
length byte if you modify the address field. 

9.3.3 BASIC variables 

The reader will have noticed that both numbers and 
strings in BASIC are represented as 5-byte objects. 
This means that the construction of a variable table 
for the BASIC interpreter to use is straightforward. 
This table has two components: 

(1) The variable name 

(2) The variable 'value ' 

We assume here that the value of a string is actually 
the value of its descriptor. 

The built-in BASIC function VARPTR returns a numeric 
value which is an index to the system ' s variable table . 
An example, in BASIC, of this is: 

10 A$ = "HEBE IS A STRING" 
20 PRINT VARPTR (A$) 

This code would cause the location in the variable 
table of the string A$ to be printed. Note that the 
value returned by VARPTR is a 5-byte BASIC numeric 
variable which always represents an integer. The 
assembly language programmer must therefore convert 
this number using INTCNV before he can use it in his 
program . 

We conclude this section with a table listing the 
conversion routines, their addresses and their 
functions . 

Name Address Function 

VALTYP $06 This variable holds the type of a 

parameter to a routine initiated by 
a USR call and also the type of the 
result returned to BASIC 

INTCNV $8B2D This routine converts a BASIC 

numeric variable to an integer. It 
expects the X register to point at a 
floating-point accumulator holding 
the number to be converted and 
returns its result in register D. 

GIVABF $8C37 This routine complements INTCNV in 

that it converts an integer in 
accumulator D to a BASIC numeric 
value. GIVABF also sets VALTYP to 
zero. 
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MOVFM $D3BF This routine moves a 5-byte BASIC 

floating-point number Into the 
floating-point accumulator . The 

number to be converted Is addressed 
In register X. 

9.4 PASSING PARAMETERS FROM BASIC TO MACHINE CODE 

We have already shown, In Chapter 6, how the EXEC and 
USR calls may be used to Interface machine code 
routines with BASIC programs. The parameter passing 
technique described there Involved poking parameter 
values Into known memory addresses and peeking the 
results from other addresses. In this section we 
describe how knowledge of BASIC 'S Internal data 
representation allows parameters to be passed to 
machine code routines via USR calls. 

To help with Its 'housekeeping', the BASIC system 
keeps track of the type of parameter being passed to a 
USR function In a memory location called VALTYP. If 
the argument Is a number, VALTYP Is set to zero. A 
non-zero value assigned to VALTYP means that the 
argument to the USR function Is a string. Type 
mismatch errors, resulting In the message '?TM ERROR', 
are caused by the contents of VALTYP and the actual 
operand being Incompatible. For example, If VALTYP Is 
zero and a string Is used as an operand, a type 
mismatch occurs. 

On entry to a USR function (remember this Is defined 
by the assembly code programmer) , the A accumulator 
register reflects the contents of VALTYP. If A Is zero, 
the parameter Is numeric, If A Is non-zero, the 
parameter Is a string. 

According to the BASIC manual, the parameters to a 
USR call may be either a number or a string. However, 
experimentation with this will show that the use of a 
USR call with a string argument results In a type 
mismatch error message 'TM ERROR' being printed. We 
describe below how to pass numeric parameters to a USR 
call and also how to program around the system bug 
which causes an error when string parameters are used. 

9.4.1 Numeric parameters 

As a USR call Is a BASIC function It may only take a 
single parameter. When this parameter Is a number, the 
USR call sets up the X register to point at the FAC 
holding the number and sets A to zero, Indicating that 
the type of the parameter Is numeric. Usually, the 
first thing that the assembly language routine does Is 
convert this number to an Integer using INTCNV. 
Computation may then proceed. 

Because the USR call Is considered to be a BASIC 
function, It must return a result to the calling 
program. If the USR call Is to Initiate a subroutine 
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rather than a function, where the value returned is 
irrelevant, the convention adopted is for the assembly 
language routine initiated by the USR call to return 
its input parameter as a result. This is easily 
accomplished by returning to BASIC using a RTS or 
equivalent instruction with the X register pointing at 
the FAC containing the result . As long as the 
subroutine does not change the X register, the result 
will be the same as the input parameter. 

However, if the USR call initiates a proper 
function, it is possible to return a result which is 
not the same as the routine's input. The result is 
computed as an integer and the routine GIVABF is called 
to convert the contents of accumulator D and load the 
floating-point accumulator. GIVABF also sets the type 
indicator VALTYP to zero to reflect the fact that a 
numeric variable is being returned to the BASIC system. 

Any integer values may be returned in this way even 
when a string is the input parameter to the USR call. 
For example, consider the routine below which accepts a 
single character string as an input parameter and 
returns, as its result, the ASCII code of that input 
character. The X register, on input, points to the 
string descriptor so indirect addressing is used to 
fetch the actual string character. 

USRASC LDB (2,X) ; Fetch first character of string 

CLRA ; Zero most significant byte of D 

JSR GIVABF ; Return ASCII code in FAC 
RTS 

9.4.2 String parameters 

Although the BASIC system signals a type mismatch error 
when a string is passed to a USR call, it is perfectly 
legal to pass a string as a parameter. The error 
occurs when the result is returned rather than when the 
parameter is passed via the USR call. 

When a string is used as a parameter to a USR call, 
the X register is set up to point at the 5-byte 
descriptor for the string and VALTYP is set non-zero. 
The string descriptor format is as described in section 
9.1.2 and the assembly language routine may manipulate 
the string as required. 

The problems arise when an attempt is made to return 
to the BASIC system. BASIC expects a numeric result 
from the USR call so, if a string result is returned, a 
type mismatch error is signalled. The assembly 

language routine must somehow fool the BASIC system 
into thinking that a numeric rather than a string 
result has been returned if the error is to be 
circumvented . 

There are two ways of doing this. The BASIC system 
carries out the type checking by calling a routine to 
check that VALTYP is zero. If the assembly language 
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programmer explicitly clears VALTYP before returning to 
the BASIC system, the return will execute normally 
because the checking routine will see that VALTYP is 
zero. However, this does mean that the result will be 
treated as numeric and cannot, therefore, be assigned 
to a string variable. 

To return a string variable properly, the user must 
cut out the call to the type checking routine by 
discarding the normal return address on the stack. This 
can be done by executing a LEAS 2,S instruction to pop 
it off the stack before a normal RTS instruction. By 
discarding the return address, you avoid a return to 
the point where the checking routine is called. The 
return which is actually executed is a return to the 
statement immediately after the call to the this 
routine . 

The way to return strings from a USR function is 
best illustrated by example. The example chosen is a 
modification of the USRASC routine presented in the 
previous section. The routine shown below accepts a 
string as its parameter and returns the same string 
with the first character incremented. 

USRINC LDB (2,X) ; Fetch first character of string 

INCB ; increment it 

STB (2,X) ; and store it back 

LEAS 2,S ; Discard return address 
RTS 

If this routine is assembled using the standard DREAM 
settings, then the following BASIC program can be used 
to test it. 

10 DEF USRO = 20001 'Default code address 

20 A$ = "123" 

30 PRINT USROO(A$) 

40 STOP 

When this program is run "223" will be printed by line 
30 . If the program is then listed, statement 20 will 
be converted to A$ = "223" showing that the string 
descriptor associated with A$ points to the BASIC 
program text area. Because string descriptors may point 
into the text area, you must be very careful when 
modifying strings as such changes can corrupt the 
surrounding BASIC text. 

To avoid string descriptors pointing into the BASIC 
text area, it is possible to force space for the string 
to be allocated in the string storage area. One 
technique makes use of the fact that string catenation 
results in the string descriptor referring to the 
string storage area so catenating the empty string to 
another string ensures that the string descriptor does 
not point to the text area. In the above example, this 
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involves changing statement 20 to A$ - "123" + "". 

An alternative technique may be used when it is not 
important what characters are passed as an input string 
as the string will be built up by the USR function and 
then returned. The most convenient method of creating 
a suitable string descriptor is to use BASIC'S STRING$ 
function. For example: 

A$ = USROO (STRING$ (" ",255)) 

This creates a descriptor to a string made up of 255 
blanks. If you know the length of the string to be 
returned, you can obviously set it up as required. If, 
however, the length is unpredictable, you should create 
a descriptor for the longest possible string (255 
characters) then modify the length byte to reflect the 
actual string length. This way, you can be sure that 
sufficient space is always available for the actual 
string characters. 

A useful side-effect of using a string as a 
parameter in a function call is that the Y register is 
set up to point at the first character of the string. 
There is therefore no need to extract the address from 
the string descriptor. As a result, the indirect 
reference, (2, X) , to the first character of the string 
in USRASC and USRINC can be replaced by a normal 
indexed reference using Y. 

This side-effect also applies to VARPTRed strings so 
there is no need to convert the numeric value to an 
integer with INTCNV to get the string descriptor. 
Therefore, the code sequence: 

JSR INTCNV ; Convert to 16-bit value 

TFR D,X ; and transfer to index register 

LDB (2,X) ; and reference character indirectly 

may be replaced with the single statement LDB , Y. 

9.5 EXTENDING THE DRAGON'S CAPABILITIES 

One way of extending the Dragon 's capabilities is, of 
course, to call your own assembly language subroutines 
from BASIC and we have described how to do this in the 
above section. However, it is also possible to augment 
the BASIC system with new commands which carry out 
functions which are not provided in Extended Color 
BASIC. 

To add new commands to BASIC, you must add new 
reserved words to the language and this involves 
extending the reserved word table described in section 
9.2. Information concerning the reserved word tables is 
contained in an area of RAM called a command 
interpretation vector or 'stub'. This information is 
structured as follows: 
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Byte Use 

Number of normal reserved words 

1:2 Address of normal reserved word list 

3:4 Address of normal reserved word dispatch table 

5 Number of function reserved words 

6:7 Address of function reserved word list 

8:9 Address of function reserved word dispatch table 

A number of such command interpretation vector tables 
may be used provided that they are contiguous in RAM 
and that the last used table is followed by a zero 
byte. Extended Color BASIC uses two such tables 
although the second table is simply a dummy stub with a 
zero in its first byte indicating that it is a 
terminator. The first stub occupies RAM space from 
addresses 120-129 inclusive with each entry set up as 
shown in the table below: 



RAM byte 


Contents 


120 


4E 


121:122 


8033 


123:124 


8154 


125 


22 


126:127 


81CA 


128:129 


8250 



To add new commands, the user must define a new stub 
following the normal BASIC command interpretation 
vector table and this must be followed by a terminator. 
The format of user-supplied stubs differs slightly from 
the standard BASIC stub in that bytes 3 and 4 and bytes 
8 and 9 should contain the addresses of new dispatch 
routines for the added commands rather than the 
addresses of dispatch tables. 

We illustrate the process of extending BASIC by 
showing how two new commands may be added. These 
commands are a HELP command which prints some user- 
supplied 'help ' information and an OUTPUT command which 
is exactly the same as PRINT. To add these new 
commands requires that the following steps should be 
carried out. 

(1) Set up a new reserved word table. 

(2) Set up a new reserved word dispatch routine. 

(3) Define a new stub with references to this new 
table and associated routine. 

The first step, setting up the reserved word table, is 
straightforward. This table is made up of the 
characters in the word with the last character having 
its top bit set to indicate 'end-of-word' . 
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NEWRDS FCC /HEL/ 

FCB $D0 ; 'P' with top bit set 

FCC /OUTPU/ 

FCB $D4 ; 'T' with top bit set 

The new reserved word dispatch routine performs similar 
tasks to BASIC'S reserved word dispatch routine. These 
tasks include checking the validity of the new token 
value, calculating the appropriate index into the new 
dispatch table and setting up the base address of the 
new dispatch table. Once this has been done, the new 
dispatch routine can re-enter BASIC ROM at the 
appropriate point to deal with the new command. 

The tokens associated with each reserved word are 
computed by the system by counting the number of 
reserved words scanned, including new reserved words if 
present . As the last normal BASIC reserved word has a 
token value of CD, the values for HELP and OUTPUT are 
CE and CF respectively. We use equates to define the 
first new token value and number of tokens and set up a 
table of dispatch addresses for the new commands. 

NEWTOK EQU $CE ; First new token value 

TOKENS EQU 2 ; Number of new tokens 

NEWTBL FDB HELP ; Address of HELP command 

FDB $903D ; OUTPUT = PRINT 

The new reserved word dispatch routine makes use of 
this information when determining which action routine 
to call. A text input routine called CHRGET is used by 
the system to scan the BASIC text and passes the token 
value to this routine in register A. A suitable 
dispatch routine for these new commands is: 

* NEWDSP - New dispatch routine 

* Register input A - token value 
* 

* This routine checks token validity and invokes the 

* appropriate action routines 
* 

NEWDSP CMPA #NEWTOK ; Check that 

BLO NEWERR ; token given 

CMPA #NEWTOK+TOKENS ; is within range 
BHS NEWERR 
* 

* One of the new commands at this point 
* 

SUBA #NEWTOK ; Convert to table index 

LEAX NEWTBL, PCR ; and set up table base 

JMP ROMCMD ; before jumping to BASIC 

NEWERR JMP SYNERR ; error jump into BASIC 

The HELP routine is very simple and also makes use of a 
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ROM routine to perform some of its duties: 

HELP LEAX HELPME-1,PCR ; Point to byte before 

JMP OUTSTR ; string for ROM's OUTSTR 

Notice that the above routines have no explicit RTS 
instructions as the terminate by jumping to ROMCMD, 
OUTSTR, etc. Returns from these routines therefore 
return to the program which called the new dispatch 
routine. These routines also use a number of equates 
which are defined as follows: 

OUTSTR EQU $90E5 ; String output routine 

SYNERR EQU $89B4 ; BASIC syntax error routine 

ROMCMD EQU $84ED ; BASIC dispatch point 

The HELP message is held in an area of store named 
HELPME and is output by a standard output routine 
called OUTSTR. This routine takes as its parameter the 
address of the byte before the string and expects the 
string to be terminated with a zero byte. 

HELPME FCB $0D 

FCC /DON'T ASK ME I'M ONLY A MACHINE/ 
FCB 

After defining the dispatch routine, a new stub must be 
set up. Unfortunately, the address of the zero byte 
required to mark the end of stubs clashes with the 
first byte of USR vectors (134) . However, this has 
been allowed for in Extended Color BASIC as the USR 
vector is referenced indirectly through the direct page 
location B0:B1 and the USR vector area may be moved 
elsewhere and these locations filled in with its new 
address . 

The following routine sets up a new stub and 
relocates the USR vectors. 

* NEWSET - set up new stub for reserved words 

* Register input NONE 

* Registers destroyed A,X,Y,CC 

NEWSET LDX #STUB1 ; First of all copy 

LDY #STUB2 ; old second stub 

NXTBYT LDA ,X+ ; bytes into 

STA ,Y+ ; third stub 

CMPX #STUB2 

BLO NXTBYT 

LDA #TOKENS ; Number of reserved words 

STA STUB1 ; set up new stub 

LEAX NEWRDS,PCR ; New reserved word list 

STX STUB1+1 ; set up 

LEAX NEWDSP,PCR ; New dispatch routine 

STX STUB1+3 ; set up 
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* No new functions so second part of stub unchanged 
* 



NXTVEC 



LEAX NEWUSR, PCR 

STX USRPTR 

LDY #FCERR 

LDA #10 

STY , X++ 

DECA 

BNE NXTVEC 

RTS 



; Relocate the USR 
; vectors 
; and initialise 

; them to FC ERROR 
; continue until all 
; done 



This routine assumes that the following equates and 
declarations have been made: 



STUB1 


EQU 


$12A 


USRPTR 


EQU 


$B0 


FCERR 


EQU 


$8B8D 


NEWUSR 


RMB 


20 


* 






* 







; Address of second stub 

; USR vectors 

■ FCERR entry point 

; relocated USR vectors. Must be 

set up before defining any USR 

addresses 



9.5.1 RAM hooks 

The BASIC system designers allow new commands to be 
added to BASIC so that extra commands needed to support 
a disk version of BASIC may be included. However, some 
of the existing commands such as OPEN and CLOSE also 
need to be enhanced for disk BASIC and so addresses 
have been set up in RAM which allow extra facilities to 
be added to action routines. These addresses normally 
contain an RTS instruction so that a reference to them 
from within an action routine does nothing. The RAM 
addresses are called 'hooks ' and the RTS instruction 
may be replaced by a jump to some other routine which 
enhances the capabilities of the action routine. 

There are a total of 25 RAM hooks available at 
locations 15E to 1A8 inclusive . A brief description of 
each is given in the following table. 



Address 


Called from 


15E 


B829 


161 


B1EC 


164 


B596 


161 


B54B 


16A 


B50B 


16D 


B624 


110 


B63D 


113 


B65D 


116 


B664 


119 


84DE 


11C 


8192 


11 F 


B11C 


182 


B5C1 


185 


B6FE 



Potential use 
Open device or file 
Check I/O device number 
Return device parameters 
Character output 
Character input 

Check device is open for input 
Check device is open for output 
Close all devices and files 
Close a single device or file 
About to deal with first 
character of new statement 
Disk file item scanner 
Poll for BREAK and special keys 
Read a line of input 
Finish loading ASCII program 
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B801 


18B 


8954 


18E 


8344 


191 


834 7 


194 


85A5 


197* 


8C80 


197* 


8424 


19 A 


849F 


19D 


86D7 


1A0* 


BA60 


1A0* 


9EEB 


1A0* 


AAF7 


1A0* 


850F 


1A3 


8F67 


1A6 


8F08 
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End of file (EOF) function 

Evaluate an expression 

User error trap 

System error routine trap 

RUN statement 

String copy check 

CLEAR statement 

Fetch next statement 

LET string copy check 

CLS statement 

RENUM statement 

PUT/GET statement 

Function assignment 

Compress BASIC line for storage 

Expand BASIC line for listing 



Starred addresses in the above table mean that several 
hooks share the same address . The only way to 

determine which is used is to check the return address ! 

In order to use some of these RAM hooks, you need an 
in-depth knowledge of the BASIC interpreter and, 
therefore, these hooks are not useful to the ordinary 
programmer. However, some of the hooks are very useful 
indeed and can be used to enhance the standard system 
facilities . We shall illustrate this by showing how 
the character output hook ($167) can be used to copy 
all character output to the printer and how the new 
statement hook ($19A) can be used to force a complete 
keyboard scan . 

Our first example involves setting up the character 
output hook with the address of the printer output 
routine. 



LPTOUT 
HKCHRO 
HKUPCO 



EQU $800F 

EQU $167 

LDX #LPTOUT 
STX HKCHRO+1 

LDA #$7E 
STA HKCHRO 

RTS 



Printer output address 

Character output hook 

Set up printer output address 

hook up to character output 

JMP opcode value 

into hook 



This example may be set up using BASIC pokes as it 
simply involves replacing the three bytes of character 
output hook with a JMP $800F. However, you must be 
very careful when setting up hooks from BASIC as the 
hook may be called between each POKE statement . This 
means that you must first set up the address in bytes 1 
and 2 of the hook and, as the last step, replace the 
RTS instruction with a JMP instruction . The following 
BASIC statements set up the character output hook. 



POKE &H168, &H80: POKE &H169 , &HOF : POKE &H167, &H7E 
It is not easy to find out which registers roust be 
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preserved when a hook is called so you must save all 
registers, including CC, used in the hook routine. We 
didn 't do this in the example above as this routine is 
also called by the normal character output routine when 
a PRINT #-2 is used. We therefore assumed that the line 
printer routine preserves the registers itself. 

In our second RAM hook example we show how the new 
statement RAM hook can be used to reset the row state 
byte ($151) to a value which forces a complete keyboard 
scan. The following code is made up of necessary 

equates, the routine used to reset the row state byte 
and a routine to set up the RAM hook. 

HKNWST EQU $19A ; New statement RAM hook 

KBROWS EQU $151 ; Keyboard row state byte 

* 

* RSROWS - reset row state byte 
* 

* Register inputs NONE 

RSROWS PSHS A, CC ; Save registers 

LDA #$7F ; This value forces a scan 

STA KBROWS ; of the keyboard 

PULS A,CC,PC ; Restore and return 

* 

* HKUPNS - set up RAM hook 

* 

HKUPNS LEAX RSROWS, PCR ; Address of hook routine 

STX HKNWST+1 ; reset row state routine 

LDA #$7E ; JMP opcode 

STA HKNWST ; into hook 
RTS 

Setting up this hook means that all key depressions 
will be recognised, even those on the same row. A 
similar technique can be used to disable the BREAK key 
thus stopping the user interrupting a program and to 
provide auto-repeat facilities on some or all keys. 
Both of these additions involve modifying RSROWS above 
so that the appropriate column bytes are modified. 

The BREAK key can be disabled by adding the 
following code to the above program. 

BRKCOL EQU $154 ; Break row byte 

BRKCLR EQU $BF ; To clear BREAK'S bit 

LDA BRKCOL ; Pick up BREAK column 

AND A #BRKCLR ; Force BREAK bit to 

STA BRKCOL ; and store it back 

9.6 BASIC SYSTEM VARIABLES 

In this final section we list the reserved memory 
locations used by the BASIC system and describe, very 
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briefly, what these locations are used for. As these 

are RAM locations, you may modify them using POKE but 

you must be very careful if you do so. If you make a 

mistake or set up an invalid value, you may hang the 

system. This means that you can do nothing except 
switch the machine off and on again to reset it and all 
your work currently in RAM will be lost . 

We start with a list of variables held in the first 
256 bytes of memory and accessed via direct addressing 

with the direct page register set to 00. 

Address Use 

00 BREAK message flag. If negative print BREAK 

01 String delimiting character 

02 Another delimiting character 

03 General count byte 

04 Count of IFs seen while looking for ELSE 

05 DIM flag 

06 VALTYP - 0=numeric, l=string 

07 Garbage collection flag 

08 Subscript allowed flag 

09 INPUT/READ flag 
OA Arithmetic use 

OB:OC String pointer - first free temporary 

OD-.OE String pointer - last used temporary 

OF-18 Temporary results 

19:1A Pointer to start of BASIC text 

1B-.1C Pointer to start of simple variables 

ID : IE Pointer to start of array variables 

IF: 20 End of storage in use 

21:22 Stack base address 

23:24 String space base address 

25:26 Temporary pointer to new string 

27:28 Address of top of RAM used by BASIC 

29:2A Last BASIC line number 

2B:2C Input line number 

2D:2E Old text pointer 

2F : 30 Another text pointer 

31 : 32 DATA line number 

33:34 Pointer for DATA 

35:36 Pointer for INPUT 

37-4E Evaluation variables 

4F Floating point accumulator, FAC exponent 

50-53 FAC mantissa 

54 Sign of FAC 

55 Temporary sign of FAC 

56-5B String descriptor temporaries 

5C Floating point argument, ARG exponent 

5D-60 ARG mantissa 

61 Sign of ARG 

62-67 Miscellaneous use 

68 : 69 Current line number 

6A-6E Device parameters used in PRINT 

6F Device number, O-console, -1-cassette 
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-2-printer 

70 End of file flag 

71 Restart flag ($55 warm, other cold) 
72:73 Warm start vector (points to NOP) 
74 : 75 Top of RAM minus 1 

76:77 Unused 

78 Cassette file status (O-closed, 1-input, 
2-output) 

79 Number of characters in CASBUF 
7A:7B Cassette buffer pointer 

7C Block type (0=header, l=data 

FF=end of file) 

7D Block length 

7E: 7F Address of cassette buffer 

80 Block checksum 

81 Checksum error flag 

82 Pulse width counter 

83 Sync bits counter 

84 Bit phase flag 

85 Last sine wave value 

86 Used in SET, RESET, and POINT 

87 Single character keyboard buffer 
88 : 89 Current cursor address 

8 A : 8B 1 6-bi t zero 

8C Sound frequency 

8D Sound timer 

8F Cursor blink rate counter. 

Initial value = 32 
90:91 Count of number of leader bytes 

Initial value 0080 

92 Minimum cycle width of 1200Hz 
Initial value = 12 

93 Minimum pulse width at 1200Hz 
Initial value = OA 

94 Maximum pulse width at 1200Hz 
Initial value = 12 

95:96 Cassette motor delay value 

97:98 Keyboard debounce delay value 

Initial value = 045E 
99 Line printer comma field width 

Initial value = 10 
9A Line printer last comma field 

Initial value = 74 
9B Line printer width 

Initial value = 84 
9C Line printer head position 

9D:9E EXEC vector 

9F:A0 INC $A7 ; CHRGET input routine 

Al :A2 BNE $A5 

A3:A4 INC $A6 

A5-A7 LDA >0 

A8-AA JMP $BB26 

AB-AE Used by RND 

AF Program trace flag, O-trace off 

non 0, trace on 
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B0:B1 Pointer to USR vector base 

B2 Foreground colour 

B3 Background colour 

B4 Active colour 

B5 Active colour 

B6 Graphics mode 

B7:B8 Top of current graphics screen 

B9 Number of bytes in graphics row 

BA:BB Base address of current graphics screen 

BC Page number of graphics screen 

BD:BE Current X position 

BF:CO Current Y position 

Cl-DD Used by graphics 

DE MUSIC octave 

DF MUSIC high volume 

EO MUSIC low volume 

El MUSIC note value 

E2 MUSIC tempo 

E3:E4 MUSIC duration count 

E5 MUSIC dotted note flag 

E6-FF Unused in Dragon 32 

BASIC also uses a number of system variables between 

addresses 100 and 3FF. Their use is summarised in the 
table below. 

Address Use 

100-102 SWI3 secondary vector 

103-105 SWI2 secondary vector 

106-108 SWI secondary vector 

10 9-1 OB NMT secondary vector 

10C-10E IRQ secondary vector 

10F-111 FIRQ secondary vector 

112:113 TIMER value 

114 Unused 

115-119 Random number seeds 

11A-11F Unused 

120 Stub - number of reserved words 
121 : 122 address of reserved word table 

123:124 address of dispatch table 

125 number of functions 

126:127 address of function table 

128:129 address of function dispatch table 

12A-133 Stub 1 

134-147 USR address table 

148 Auto line feed flag 

149 Alpha lock flag O=lower case 
FF=upper case 

14A-150 Line printer EOL termination sequence 

151-159 Keyboard matrix state table 

15A Right joystick X-value 

15B Right joystick, Y-value 

15C Left joystick, X-value 

15D Left joystick, Y-value 

15E-1A8 RAM hooks 
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1A9-1D0 String buffer area 

1D1 Cassette filename length 

1D2-1D9 Cassette filename buffer 
1DA-2D8 Cassette file data buffer 
1DA-1E1 Cassette filename (in buffer) 
1E2 Cassette file type, O=program 

l=data, 2=machine code 
1E3 Cassette ASCII flag, 0=binary 

FF=ASCII file 
1E4 Cassette gap flag, O=continuous 

FF=gaps 
1E5:1E6 Execution address of machine code file 
1E1-.1E8 Load address for ungapped machine code 

file 
2D9-2DC BASIC line input buffer preamble 
2DD-3D8 BASIC line input buffer 
3D9-3EA Buffer space 
3EB-3FF Unused in Dragon 32 



Reading list 



This reading list is simply a list of books which may 
be of interest to the Dragon user who wants to follow 
up some of the ideas and techniques introduced in this 
book. As there are literally thousands of books on 
computing available, it does not pretend to be a 
complete list of all relevant books. 

As the Dragon is very similar to the Tandy Color 

Computer, articles on this machine may be of interest 

to Dragon users. Many such articles have appeared in 

'BYTE', a US computing magazine, and back issues of 

this may be available through your local library. 

There are also many other magazines devoted to 
personal computing, including one specifically for 
Dragon users. Readers of this book will probably have 
their favourite periodical but we think that 'Practical 
Computing ' , 'Personal Computer World ' and 'BYTE ' are 
amongst the best of these journals. 

1. GENERAL BACKGROUND 

Sommerville I. 1983. 'Information Unlimited' . London : 
Addison-Wesley 

Ullman, J.D. 1976. 'Fundamental Concepts of Programming 
Systems ' . Reading, Mass . : Addison-Wesley 

Wirth, N. 1976. 'Algorithms + Data Structures = 
Programs ' . Englewood Cliffs, NJ : Prentice-Hall 

Greenfield, J.D. & Wray, W.C. 1981. 'Using 

Microprocessors and Microcomputers - the 6800 Family ' . 
New York : Wiley 

Peatman, J.B. 1977. 'Microcomputer-Based Design'. New 
York : McGraw-Hill 

2. ASSEMBLY LANGUAGE PROGRAMMING 

Wakerly, J.F. 1981. 'Micro-computer Architecture and 
Programming' . New York : Wiley. 

Leventhal, L.A. 1981. '6809 Assembly Language 

Programming ' . New York : Osborne /McGraw-Hill 
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Zaks, R. & Labiak, W. 1982. 'Programming the 6809'. 
Sybex 

3. DATA STRUCTURES 

Knuth, D.E. 'Fundamental Algorithms'. Reading, Mass. : 
Addison-Wesley 

Shave, M. 1975. 'Data Structures'. Maidenhead, Berks. : 
McGraw-Hill 

4. GRAPHICS PROGRAMMING 

Barden, W. 1982. 'Color Computer Graphics'. Fort Worth, 
Texas : Tandy Corp. 

Foley, J.D. & Van Dam, A. 1979. 'Fundamentals of 
Interactive Computer Graphics'. Reading, Mass. 
Addison-Wesley 

Inman, D. & Inman, K. 1983. 'Assembly Language Graphics 
for the TRS-80 Color Computer ' . Virginia : Reston 

5. I/O PROGRAMMING 

Staugaard, J.R. 1981. '6809 Microcomputer Programming 
and Interfacing ' . Indianapolis : Sams &, Co . 

Artwick, B.A. 1980. 'Microcomputer Interfacing' . 

Englewood Cliffs, NJ : Prentice-Hall 

Pritty, D.W. & Smeed, D.N. 1984 (to appear) . 'Practical 
Electronic Interfacing to Popular Microcomputers ' . 
London : Addison-Wesley 

Lesea, A. & Zaks, R. 1978. 'Microprocessor Interfacing 
Techniques ' . Sybex 

Witten, I.H. 1980. 'Communicating with Microcomputers'. 
London : Academic Press 

Andrews, M. 1982. 'Programming Microprocessor 

Interfaces for Control and Instrumentation ' . Englewood 
Cliffs, NJ : Prentice-Hall 



Appendix 1 
MC6809E data sheet 

Supplied courtesy of Motorola Semiconductors. 

The Information here has been carefully checked and Is 
believed to be entirely reliable. However, no 
responsibility Is assumed for Inaccuracies. Motorola 
reserves the right to make changes to any products 
herein to Improve reliability, function or design. 
Motorola does not assume any liability arising out of 
the application or use of any product or circuit 
described herein. No licence Is conveyed under patent 
rights In any form. When this document contains 
Information on a new product, specifications herein are 
subject to change without notice. 
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PpQRT »Po*l Pow*t Deflation. Wans- - User DMS 
For mt l ■•■i i ■ itmrB PpQfl**P|NT and can b« neglected PpCRT may become agnri a I h ,f h tev ■ • ■ ■- figured id 
dfrvft Darlington bases or sin* LED loads 

.".' spprojomHe retotwwship between Prj and Tj (M PpQRT K negie* !i 

Pp«K- <Tj.273 l 'Ci (2) 

Saving equations 1 and 2 foi ' 

K - Pp*iT A ♦ 273*C3 * ffjA»PD 2 ( 3> 

■ •!-■ It isa constant pef'aining to thepariicuEar patt K cat : ■ ■< itont equation 3 by measuring Pq (at cq-.. : i 

lot aknnwn T^ . VJsmy thisvaiueo* K Rvalues nt Pp and Tj can be obtained by sowing t>i . - , 

value oJ 1 a 



DC ELECTRICAL CHARACTERISTICS 
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BUS TIMING CHARACTERISTICS ■ ■• V ■■ 
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MGURE 1 HEAD. WRITE DATA TO MEMORV OR PERIPHERALS TIMING DIAGRAM 
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FIGURE 2 EXPANDED BLOCK DIAGRAM 
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FIGURE 3 RUS TIMING TEST LOAD 
50V 



MMUSIWS L" i2kD 



T«T Paint O 




C-30pf Im BA. BS LlC AVM* Hl^ 
IX pF Kir DODJ 
90 pF ffv AOAtb. M/W 

H 1 Wfcfl Tor 00-O7 

16b kU for AD A1&, H W 

7* tOl AVWA BUSY 



PROGRAMMING MODEL 

As shown >n FigurM the ■M'CfitiOiJE. ad ■ " ■ agisters to 
the set available in \Yva MCtitiQQ The adtio-ii n 
a direct pagt J register, th+* oset stack pointer, arid a second 
mde* reojslttr 

ACCUMULATORS (A, B, Dl 

the A and B logtflws are (jerwrdl purpo^ accuniulatots 
whrch are used lor anthrt*etic calculations and mai 
- :.r : 

Certain instructions concatenate ihe A and B registers To 
•ijte 16 bit accurnufaior Th» js foleowJ tfl 
md js f oh med wit h t he A register as the i nost agmf i 
!■■ ' i ;'• 

DIRECT PAGE REGISTER lOP) 

Thedin.4 r | :■]■ ■ : Kef of the MC9809E serves ti 
Ihe direct addressing mode The COfflvnl u' Uus ragtstor 
appears at the higher address outputs (AS-AT5) during direct 
addressing instruction esacubon This allows the tinea 
mode lo be used at any ptact? in memory, unite* program 
control Tn ensure M6B0O compatibility, all tuts ol thrs 

r [W ,ift cleared during pn 
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FIGURE A - PROGRAMMING MODEL OF THE MICROPROCESSING UNIT 



h ■ lj 

■■ ■ 
■ 



S HiMuvj i 



PC 

X 



F 

■ 



QP ■>■■>. 

j s 

l 3. [ > I H J I J N [ I I V ] ^ | 



INDEX REGISTERS .X. V. 

;,....;■. 

■.!.■■ ■ 

.-■■■■. 

..■"■■ . )ial con 

■ .. | | ■ • - | ■.. . 

, . , . ... 

merited to ponit tn the n**i Hem ot te3 

■'■■;■'• ■ i ■ ■■ : ■ 

STACK POINTER (U. Si 

. . ■ ■ i - , 
■jjruinnici This alines ipgumwrts tti be passed ti 

. i^trtl iiS iS 

■ ■ ■ i ■' i tch pcmivrs - 

. .: -i*ti*js as it't. .■ ■- ■ ■■ : 
: ' Push ,- : Pull - . ■ ■ allows the 

' \ '• 'ir.temlv as a start process i 

enhancing <is atiil"K to import h*gh* r p JMAgBS amd 

; 

NOTE 

■■■■■.: I ' I " - IE | M ■ ' : I 

lha siac* »n conttasi to ■■ pomtoi 

which pointed u the ne*i ■■■■■ n i i ■ , - 

PROGflAM COUNTER 

''.[■;,■■ ' ■ &>quii to 

thaaddn.- - ; i ' ' • -■ 

HJklreSSing is provided allowing the j 
counter To be used \\V ■ 

CONDITION COOE REGISTER 
The condition ten d 

■ - ■ ' i J ■■■■■. i ■ ■ -•-;■ Figtin) 4 



Hr,uR£ 5 CONDITION CODE RFCJ5TFR FORMAT 



lh 



GCE 



I 

■ 

■ 

■ 



CONDITION CODE REGISTER 
DESCRIPTION 

BIT (CI 

BH lb. ■ , ■ : 

j C is also used to represent a "borrow 
subtract like iwti I " l NEC SUB. SBCl » 

■ i i ALU 

BIT 1 IV) 

Bi| 1 isthetivBrtlow li«js™)iv wimaonetivat 
which ca ■ ■ :■■'%'. 

Itoirt thiscivcr'i.'..' ■■---.: psrat h 

r.iiFv Iron ti ■ ' ' • ilia catty 

MSB I 

SIT 2 (Zl 

Bit 2 £ ' !■ sot to a otw il tho tra 

prify ions oppr. i ' 
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BIT 3 IN, 

■ . ■ 
M E t the result otitis preceding operation Thus ^ 

- i ■ . "n or* 

BIT 4 III 

Bit 4 is (he iRU mash bfl The pfmesscir will not r&.ognj/e 
interrupts from the? IRQ lino ii this tut a sei to a > - '- k " 
FM, IRQ RESET, and SW" :W>2 ana 

■ ■ 

arrsiHi 

the haft-carry tm and i ne a earn* 

horn b'l " ■ 

tADC Of ADDF This pit ts used by Ihe DAA instruction to 
peftorrn a ■ :■ add adjust oue*ahon The state of 

ifi undefined m all Shi ' ;"■-■" 

BIT 6 iFf 

Sit 6 i l j ut T he processor will no? 

•nTerrupts Irorn the HRQ Jine il This tut is a one 
TOT. FlEff. SWI and RFSFT ail set F to ,> one TtTq", SWf?. 
A J do noi alN - ' 

BIT 7 (El 

Bil 7 is v - 
the complete machine state \-aft ih* regiSta* 

i d to the sunset state IPC and CO rtw E bit o4 The 
stacked CC is used on a return from interrupt .FtTh to deict ■ 
mine the extent ofl (he 
left m the cond L ants oast anion 



I IfDfin localn nsl . ■ i FFFFj D 

■ . : 'V»flS * 

During.r: 'he reset liovihchjld be hef^l n .-. flti 

the doc* 1 

Because the MC€fi09f RESET pmhavaS I 
Itage higher than rf 
penpher ,t $ed to reset the 

:• ■- 9 lhat ail 

. oces^or 

halt 

A «ow level on this 1 the MPU to stop 

1* Ihe end c' the pri - t remum 

halted «nde'inii(:, .it data Whtnhaned. theBA 

Output 15 driven high knoScal 
pedance BS ^ also high which ir-di'v-fes iht i 
the halt s 1 ti -■■*■ M Fu will not reap 

temal le 1 1 ts ifirq. irQi diThoug'' w 1 

RESET will be latched 'or later response Dunng the halt 
stale. O and F Should continue To nun normallv A halted 
state 1BA» ■ . illmg hAl T Fcm 

while flTSTT a still low See Figure 1 

BUS AVAILABLE. BUS STATUS iBA. BSl 

liOf of an internal 

COntroF Signal v, * 
irnpedan-ce When BA ; 
before the MPU acquires the bus BA wjH ' 
when TS thus allowing dead cycle consistency 

tpui signal, when decoded with BA 
represenls the MPu state I valid with leading edge of Q.i 



PIM DESCRIPTIONS 

POWEfl iVss Vcc 1 

Two pi r ' ; - power in the part VsS *s 

ground ** veils, while \fQC ,s *^0 V 1 5% 

ADDRESS BUSlAO -A15J 

Sixteen pms .ire used to output address inlorniau 
the MPU onto The address bus Whan the processor does 
not require the bus tor a data transfer, n will oujput address 
FFFF jff, R/W' 1, and BS: 0, this r- , 
vMA veto AFF address bus drivers are mad 
impWtonOB when output bus available EBAJ is hig' 
TSC isasacfted EachprniwiWdnveoni ■ ■ 
tpur LSTTL loads and 90 pF 

DATA BUS IO0-D7) 

T hese otyht pms provide communication with thu 
tjidjroctionai data bu Each : --. : ■ 
load or tour LSTT[ loads and 130 pf 

READ/WRFTE1R Wl 

This Signal indicates ihe direction of data Iransffti or* the 
A low indicates lhat [he Mpu is anting data onto 
the data bus hvW is madfl high impedance whwn BA is high 
or when TSC is assarted 



RESET 

A low level on this Schmut tngger input for g r ' 
one bus > 1 teaeliheMI .- jure 6 The 



MPU Stare 


MPU Siate Definition 


BA 


BS 


1 


1 




■ 



Interrupt Acknowledge noj ated dun r>g bo th cycles of a 
■ fetch 1 RE SET S*n7"l FTTTO »"RQ. SWI 
SWI2. SWI3F This s>gnal. plus decoding of the lower foul 
address lutes can provide the u^i with jn indication of 
Which mtenrupt level rs b©rtgserirtced and afFpw Vfli I 
device See Table 1 



TABLE 1 - MEMOPV MAP FOR INTERRUPT VECTORS 



Vector Location! 


Interrupt Vector 
DHCrrplton 


MS 


LS 


FFfE 
fFFC 
FFFA 
FFFfi 
FfW 
FFfJ 

FFF0 


; | | 
FFfD 
fff B 
FFF9 
FfFI 

Ffl.l 
FfFI 


NMI 
SWI 

FIBQ 
SWVU 

■. 

Reserved 
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FIGURE 10 - CLOCK GENERATOR 
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* 3 V 
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— I !> Q to Sv^len^ irxJ ProcessOi 



*t to Pnocessoi 



NOTE if optional tircun is noi included the CLR antf PRE 
inputs of U2 and U3 mijsi be t»ed high 



FIGURE 11 - HEAD'MQDIFY WHITE INSTRUCTION EXAMPLE {ASL EXTENDED INDIRECT! 



Conienis Description 

ASL indexed Opcode 
Extended indirect Posibyte 
indirect Address Hi-fiyte 
indirect Address LP- B vie 
Next Mam instruction 



El lee nve Address Hi-Byte 
Ellectiue Address Lo-ftyve 



Memory 
Locanon 


Memory 
Con ten is 


pc— $oa» 


S68 


S0201 


$9F 


SOJ02 


$63 


»209 


$00 


MKW 






^-— -^ 


$6300 


!E3 


$6301 


*oe 



SE3D6 



larger Dal4 
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ADDRESSING MODES 



The bra tractions o* any computer aw greatly en 
- ■ oi powerful addr*?ssnig modes The 
MC6BQ9E has the most complete set of addressing modes 
tvariabta or> any microcomputer lode* For eaami 

MC6IX1SL has ^9 basic instructions, however, it recogni/es 
1£63 different variations of Wid addressing 

■ , ■■ ■ tuogram 

mi ng techniques The tjjttowmg addTftsang modes i 
Ihe MCfi809F 
Inner em I includes Accumuialoil 

■ -. 
Extended 

• ■■• ■ '■■ . i'if]iruCT 
Direct 

\ I 
■ ■ ■ ■ 
Zero Offset 

I 
Accumulator Of I Set 
Auto it'. - De iTjment 

Indeneu Ind ■■ 
■ 

■ ■ fnng 
j' it- Count* ReU 1 

INHERENT (INCLUDES ACCUMULATOR! 

In th*s addressing mode- ihe opcode of Ihe mi I 
contains i " ■■ ■ : pi ■•'■,, £i irnpies o' 

DAA. SWi. ASRA and 
CLR8 

IMMEDIATE ADDRESSING 

- elective address or ihe data 
is the location immediately • ■ 

rwirtg the 

[ ■ the insp ii" ih B- and 

16-hii immediate values depei In I argument 

.[ ■> I bv the t ■■ ■ !■ rj - '■ wtih > rf 

■ 

i DA #$20 
LDX fSfQOO 

LDV m 

NOTE 

: . 

. id the MC68Q9 as* i 

EXTENDED ADDRESSING 

■ rrig, the contents ot ihe two bytes 

imrnedrate/y Mtowng the opcode fully specrly the 16 bar 
■■■ i bv the instruction Note mat ihe 
address generated by an extended instruction defines an 
absolute address and is not position independent Examples 
of eHiended .i I ■ ide 

L.DA CAT 

MOUSE 



EXTENDED INDIRECT 

;- ol indexed addressing 'discussed 

betowJ. one Jevel rjl indirection may be added to • -"- ' ded 

- landed indu* . ' : .u>*> toftowmg the 

postbvte of an indexed instruction contain the address of it* 

LDA |CAT1 
LDX ISFFFtI 
STU IDQGJ 

DIRECT ADDRESSING 

Direct H-f ■■■■■ milar to e* tended address h . 

that only I ol lows Ihe opcode I I ."■ 

phi biis of the address to be used The 
upper etght bus ot the address we supplied bv the direct 
I >tet Since only one bvte of address is required m 
direct ad> J' Jessmemor, 

eutes taster than emended addressing Ot course, only 256 
locations (one page> can be accessed Without red*' 
contents g»te* Since the DP register is set lo 

500 an reset, direct addressing on the MC6809E ■■■■ >[ ,vr : 
compatible with direct address ng on the M6800 Indirection 
cS not allowed m du eh:- i - -. at direct 

,.; ir.- tmg are 

lOA where DP =$00 
LDB where DP = StO 
LDD <(AT 



NOTE 

direct 

addressing 

REGiSTEfl ADDRESSING 

Sonne ■![ ■ 'allowed by a byte mat -i 

• i set of registers to he used by ihe instruction This 
t postbyte Some e*ampkft of register addressing 
are 

IfR ■ * Transfers X .nio V ^ 

FXG A B Exchanges A 

PSHS A, B, X. V Push V K, B and A onio S 

slack 
PULU X. Y, D ■ and Y Irom U 

stack 

INDEXED ADDRESSING 

m all indexed addressing, one o' the pointer registers ix. 
¥ . U. S . arid sometimes PC i is used m a carcutanon ol the ef 
tec'tive address of the operand to be used by the instruction 
five basic types of indexing a*e available and are discussed 
ha postbvW of an m desert instruction specifies (he 
basic type and ...-■- the addressing mode, as well as 

me pointer register to be used Figure lb i«sts the legal for 
mats 'or the postbyle Table 2 gives the assembler form' and 
the number of cycles and bytes added to the basic values for 
mdeied addressing lor each variation 
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FIGURE 15 - INDEXED ADDRESSING POSTBVTE 
REGISTEH BIT ASSIGNMENTS 



'^^y Byta Wiw toW f ii r 



» = Dtin'l Cam 
d=0'r*el Bil 
_0-Ndt EndttflCI 
I iinitt 



AdtfttW i.;, 



; .. 



F.A = .R • ACCB Qtrsel 



R » 6 Bh Qlliei 



. D Ofrsel 



EA » PC - B B.l OIlMt 



tA • PC . 16 Bn OHsel 



EA ■ | AdESieKl 



-Adaraiano Mode Field 



i lei .- ! eld 



B r when b/ = 01 



-Register Fatln" RR 



01 - t 
It- 5 



ZERO OFFSET INDEXED In this mode. Ihe Reeled 
Dotnte* ...;■ g .iddress Dl Ihi • ' 

be used by ihe inslniciicm I his s she lasiesi indexing mode 

LDD 0. X 
LDA S 

CONSTANT OFFSET INDEXED In lots mode, twos 
complement o'tset and Ihe contents of one ol it . 

»e added to lorm ihe off bc live address a I the 
operand The pointer register 
bv the addition 

'-<zes dl ollspi : 

&twi-ieii 

ft toll I liBlr 

16 ton I -32766 to - 
The twos complement & to-" ■ I 
bvte and. thereloie. • 

he two* complement 8-pii dflsei is contained in a 

.'« following the pcislbvle The twos con 
»6 bit oltset >r. ■ f!es tallowing the pc 

r> the tiroqramrrnjf need nol oeconci J r' • : | 

si/e of ihn oitt. ■ 
si/e automatically 

- 

LDA 

LOX -2.S 

LOY 300 X 

LOU CAT.V 





TABLE 2 INDEXED ADDRESSING MODE 














Type 


Form* 


Non Indirecl 


Indirect 


AnembVar 
Form 


Ponbyla 
Op ode 


~ 


/ 


A»embto[ 
Form 


PottbytB 
Opcode 


* * 

- » 


Conslanl Ottsat From R 
■ i n-mcnt Otfsetsa 


\ -...- 


,R 


IRROOIOC 






IHI 


IRHlOtOO 




■ HI ■■ ■ 


n. R 


ORflnnnnn 


' 




default* lo 8 b.T 


S BilOttsel 


n, H 


1RR01000 


■ 


■ 


In. Rl 


iRPiioorj 


: 


' 


16 HilDttsel 


.. H 


IRR0100I 


■; 


. 


In Rl 


1RRU0O1 




-■ 


Accumulator Ottset From fl 


A Register Offset 


A. R 


IRROOHO 


• 




IA ni 


iRRtnitt) 


i 




B Reyater OHsel 


■i H 


■i,i-..'./ 


1 




IB Rl 


IRH 10101 


■•■ 


■ 


D R. , 


d. n 


1HR010II 


j 




ID. Rl 


1RR1I011 


' 


■ 


Auifi Increment! Decrement R 


tncrerrtetrt Bv 1 


,R» 


tflROuOOl 


3 




nut allowed 


■ 1 Bv 2 


R . . 


IRROuOGl 


: 




1 R- -i | IRHIQOOI 


>< 


Docremeni By 1 


- H 


IB ROOD 10 


. 




nni allowed 


Fwnmt B> 2 


R 


1RR0O011 






1.- -R| 


lHH'QO'' 






Constant Offset From PC 
12* CompJement Ottstrlti 


B Bit OffM 


n, RCR 


IliOllOO 


■ 




[n PCR| 


1.. 11 too 


: 


' 


16 B.lOllsrt 


n PCR 


ImOHOI 


■ 


. 


[n PCRI 


,," ■ 


- 


. 


tMrmded Indirecl 


. ,■ ■ .\ - ;., 










In! 


1001 till 


■ 


. 



: X, ¥. U or S 

Don! Care 



HR 
■ 
:.'■ ■ 

i;: 
" 



_„and j 'ndicare Ihe numoer nt additional cycles and Ovtei tespecriviilv fnt the particu'iiF indeung war^non 
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ACCUMULATOR OFFSET INDEXED Fhts mode a 

similar 1g constant olfsei indeed enoept Ihai th* p ^ i ■ on. 
iiue in One ot tKn? a 

f the pOttlef leg ■■ •■ s^ttolotm 
; intents of both 
.. 

... | . 

useasanoffset andnoaddiiii 1 

nftheol* 

■ ■ 
Some examples ate 

IDA 

LDX D. v 

l.EAX B. x 

AUTO INCREMENT DECREMENT INDEXED r <h< 

auto increment addressing niodt. Ihe pomi 
lams the address of the operand the pointei 

I >i -s rrH.rememed tav one or two Th^s ad 
dressing; mode is uselu! in stepping Through tables, moving 
data, or creating software Slacks In auto decrement, Ihe 
pointer rugiste* > i ledpriof to use as the address oi 

Ihe data ' 

mned Mm It 
low addresses ; r ■■ 

■ -A lor tables of cither S or ' ■ 

■ 

prrj-decrement r post- increment nature o' Ihssi 
d i tows ihem to be used 10 credit- adttnona. sottware 
,- lo the U and S slacks 
Some -• m il the aula mcTBmentftiocifurwuy 

rig modes are 
LDA 

STD * l ■ 
LOB .-Y 
LDX .--S 
Care should be taken tn performing operations on lr> b«l 
pointer FogstBTS 1 X v U. Si where the same register is used 
to eafputa'te if 1 i-ness 

Consider ihe loll owing instruction 

STX llfehttd toOi 

red result »s lo store a jero in locations $0000 and 
S0001, Iheti tncrement X topomi 1O&0002 U 
.. 1 i 

- r ■■=■ : 1 holding register 

X +2~ P 'X perform auto increment 

X — (tempi do stent operatan 
INDEXED INDIRECT 

All ol the indemng modes, wifti the e*c*ptiOri of auto in 
croment . decrernerit bv one Of fl * b oil oltset, may have en 
adrjrborittl tevef of indirection specified. In indirect addiess 
ing. the - 1 tress is contained ai the local ion 

specified bv the contents ol the index register plus any olf 
set rn the e*amplir below, (he maded in 

directly using an ©tractive address calculated from the rnde* 
register and an offset 
Bel ore Execution 
A= XX (til 
• ; ■■ 



SOIOO LDA |$jO.X| 

SF01 1 S50 

$F ifjO $AA 



f A 15 m . ,- 



3H50 ■* nnw ihe 



After E»iK.i*tion 
A = SAA tactual data leaded) 
> 1F00G 

■ 
tnearnngles'. 

I indirect I Sorr* eiiftn-i 

LDA 

LDD 1 10,5 1 
LB vi 
LDD 

RELATIVE ADDRESSING 

Theoytels! following Ihe Branch opcode «i. Easel : 
a signed ■ I 'iiv be added to the prograr- 

II the branch coridmon is frue 1(1 d address 
IPC + signed of I set 1 is loaded into ihe program counter 

execution continues at the new location as +nds- 
. 'fie PC. shon 
oltseil relative Addressing modes are avertable An q* 
memory can pe reached in long 

Irnss intetp'Oted modulo /' ■ imples ol 

relative addressing are 





BtO 








BGT 


DOG 


Ishorll 


CAT 




RAT 




DOG 


LBGT 


RABBIT 


. 



RA! 
RABBIT 



nop 

NOP 



PROGRAM COUNTER RELATIVE 

The PC can be used as the pointer register with 6 or 16 bit 
signed olfsets As m relative Addressing, the oils*- 1 
10 the current PC to create the effective address The eftec 
live address is then used as the address ot the operand w 
data Pn..j' - rddressing is used lo' writirtrj 

position independent programs Tables related to >» ; 
routine -.viii maintain the same relationship after 
moued. 1 1 referenced relative 10 " ■ counter 

I VAmpfn 

LDA CAT. PCR 

LEAX TABLE, PCS 
Since program counter relative is a type ot indexing an 
additional level ot indirection is ovarl H 

LDA jCAT. PCHI 

LDU [DOG, PCRI 
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INSTRUCTION SET 



" ' 6809F is similar to that of the 

MO5800 and is upward compatible at the source code krvel 

The nuFtnl ■' opcodes has been reduced liom 7? io59. but 

because meted afctutectore md tcfdii 

. note opcodes 1-fcVitfii ell I 
reran! rjddiessmg ith ■ ■- hom 19/ to ' 

Some of the new mstrtjf.ru ji w* described mi detail 
bold* 



PSHU/PSHS 

The push in*i rut: Iron -.- - ,1 pushing onto 

either th* hardware stac* IS) or use. I k-v single 

register or set of registers with a single nsti 



PULU/PULS 

T be puM instructions have the same capaj 
tf&ttucfaoci rdje* The byto rnvneuVetefy tofownnQ. 

•' op pull opcode determines wi I 

be pushed of p I lua) push/pullse 

queme is luted - i I b*t tWwws a untOAie fagiEtfi* to push oi 

! 



i i ■ ■■; ■ i i 


— 1— ' ' 1 




ODOO-I) 


I0OO-A 


.. 


1001 -B 


■ 


■ 


• 


101 1 DPfl 


010O - s 








NOTE 


All otfrei 0d Jnd INVALID 



LEAXaEAV/LEAU/L€AS 

The LF A iirraii ■ ' : taessJ wo*fcs by caJculal 

Mfckees used hi an rrtde&ed instruction and stores 

that address value, rathe* than the data at lhat address, in a 

pornlet regisief of the internal 

ng hanhwa avariabJe to ihe pioqitirnmer Someoi 

thennplitatfon 1 ?e illustrated m Table 3 

The LEA instruction also allows Ihe user to ac i ■■ 
and tables m a pgsibCtf r I ■■ -sample 

LEA* MSG1. PCfl 
LBSR PDATA (Print mvssage routine* 



"ostbytQ 



ML 








i 































!'IH 

• 

y 
S u 

■i 



Pud Otdw 

I 

i.e. 



DP 

. >i, 

X Lo 

1 Lo 

U SH, 

PC Hi 

PC 10 

t 

' ., ,< -ii-V 

Increasinig; 

■-*■ n n\ 

I 

TFR/EXG 

Withmlhe MCbBQ&£. any register rrmn be lianslbrred 10 Df 

B*€nanged with another ol like s*», >e. 8 tut to 9 bit or 

16 bit to T6bit B-ts 4 7 ot post byte define ine source 

Wtula bits G3 represent the dentinal ion regis ler 

vd as follows 



MSGt FCC 

This sample program punts "MESSAGl U* Wff*tmQ 
MSGl, PCfl the assemble* conijiul* 
the present address and MSGl This rasull 
constant into irh** LEAX tnt.tr . . ■ ,v<ii I tie moe-ned 

Irom the PC value at the hmeot execution No nwtl 
the code is located when it is executed the < : I I 

PC will put ihe absolute- address of MSG1 mtoltie K 
pointer ragnta i he rode is totally position indjeperident 

The LEA instructions are very powerful and use an internal 
holding regisit-T * Temp ■ -■ when using 

the L[-A instruction* wrth (he juto increment i 
decrement addressing modes due to Ihe sequence ol internal 
operations The LEA interna* sequence tin-,- ■■■ ' 



LEAa Am 

r -■►■<[ 
2 b+ 1— b 
3. lemp-*- j 

lEAa.-b 

1 b - t -» temp 

2 h - l - p 



(any ot ih# T6 btt pcnnier regtsters K.Y, 
U. or S may be substituted tor a and b I 

I calculate the FA) 
; 

Hoad aJ 



ite EA with predecrement) 
Ifnotfctv b. prede ■ 
lloadai 



TABIE 3 - LEA EXAMPLES 



Imtructton 


Operation 


Commtnt 


[A , 10, X 


X • 10 -• » 


Adds & Bit Comsijmi ' ■ ' 


Lf AX WO. X 


X + SOO— X 


Adrjt 16 Bit Cunlin SCO ID X 


lEAY A, | 


-• y 


Adds B Bit A Accumulator 1u t 


LEAV D. V 


T . D — y 


Adds 16 Bit D Aiinmulotoi lo V 


LEAU - 10, U 


U - 10 — 


Suttstiacu 10 trom LI 


LEAS - 10. S 


S 10 — s 


Used ID Beset ve Aiej on SIACfa 


LEAS 10. S 


S . 10 — S 


Used in Clean Ud Suck 


LUW 5.S 


S • 5 -* X 


A Adds 
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Auto incremeni-bv two and auto decrement py two instruc 
tions work strode I EA) ■' - 5, .-. 1 | 

X, however LEAX.- X does dewemonl X LEAX |.X should 
be used to increment X by one 



Example It LftSR iBw 

Before ExecnjftOfl 5F*= FGQO 



MUL 

Multiplies the unsigni dl bers in the A and B ac 

cumulate* end o'aces thtf unsigned issuM mto Its 
accumulator This unsigned multipw also allows 
precision multiplications 

LONG AND SHORT RELATIVE BRANCHES 

The MCBftOQE ogram counter 

restive branching Eturou ■ snore memory map In 

this mode, ft ttie branch is to be taken, the 8* or 16 bu signed 
nidtid 10 1 he value at the program counter to be 
used as the, effective address This atiowi the program to 
branch any where in the 64k memory -map Position iridepen 
dent cock can pe Beatify generated thiough the use of relative 

■ ■ ■ 1 ■ ■ 

availably 

SYNC 

Atier encountering a sync instruction, the MPr 
sync stale, stops ■■ wits to * an 

interrupt < T the pend ing interrupt is nnn moskatlta iNMh pr 
maskaolei iFIRQ. ^0' ■■■- 1 II clear The pro 

a and pert or r n ihe normal inter 
rupt stacking and service routtne Since Pi'ftCl and iRQ are 
TigytrrffJ. a la* ieve-1 with a minimum duration Of 
three bus cycles rs required to assure lhat Ihe i nterru pt wO 
be taken I g interrupt is maskable iffRQ. ipCjj 

wrth its mask bit if or li set the processor will deai 
State dhd continue processing by eaecubrvg the n- ■ 
instruction Figure 16 depjiMs sync liming. 

SOFTWARE INTERRUPTS 

lefropt iS On instruct!. ause an 

interrupt and its tor letch These software m 

temupts are usw) 
debugging, trace operations, memory mapping,, and soh 

■ ■ opment systems Three levetsol SWI ,are evatteplB 
on this MO5B09E and are pftoritrA&d in the following droer 
SvVl. SWI2. SWI3 

16-SJT OPERATION 

The MC6609E has the capability pi processing 16 bit data 
These instructions mciude ic- ■ ■ ; 

Subtracts, transfers BMCtiangas pusf>es and pulls 



CYCLE- BY-CYCLE OPERATION 

■ J-; 1 Figure 
ffii illustrates the memory access sequence corresponding 
lo each possible instructor ng made m Ihe 

MG6BQ8E Each matfuCtJOti begins with jn opcode 'etch 
; If* is being inter naff v decoded, the ne*t pro 
p/am byte a ataavs fei had M 

le so This lei [' '■- i^rably speeds ihrough 

pul i Next , the operation of each opcode will folio* the 
flowchart^ VMA is an indication of FFFFjg on the address 

■- of the chart 






JAOO 



I &SP 



CAT 



CAT 



CYCIE BV-CVCLE FLOW 



CVCIB* 


Addreu 


Dan 


H'W 


Dmcnption 


1 




■■ 


1 


■ ■ 




8001 


JO 


t 


QPtStfl hF>gJ» BvtB 


< 


B0OJ 


00 


T 


- ■ ■ ■ 


& 




• 




VMA Cvcte 


5 


FFFF 


• 


1 


VMA t . 


B 


AO00 


• 


1 


Computed Br*v> 


J 




■ 


1 




e 


tfFI 


80 




StaCJ *'ign Ofdttt Sv!e af 

....■ 


9 


EMf 


1 


Stack lov. OuJe* Byltr o* 

.... - ■ 



Example 2: DEC i Intended! 



S80U0 



■ 
FCB 



SAQCX) 

$80 



CVCLE-BY CYCLE FLOW 



-, . 1, * 


Acttreu 


Data 


n w 


DeKr.ption 


1 


'■ 


• 




Opcod*- ' ' 


.' 


SQUI 


AO 


1 


Operand AQQ'&A. Ht^h Bvte 


3 


aooi 


00 


1 


LCW 6vtu 


4 


FfFF 


■ 


1 


• 


* 


AOO0 


60 


I 


ReaJ Trie Dftlu 


> 


FFFF 


• 


■ 


VMA C 


' 


1FFF 


,'F 




'• !..'.. " • ..-. ■ '". ■'.- 



Tr>» data C-un hj'j the data at ih.il particular address 

INSTRUCTION SET TABLES 
■I'jctjonsof (he UC6cXBt have been brot^ 

B-bd ooerafpni 

16-bH opeTalion i Table b> 

...... 

Reiat've branches riong or shor» iTabip 7 J 

■■■ ^.-ous instructions L Table Bi 
He»adei '-tctions are given m 

Table 9 



PROGRAMMING AID 

Figure 18 conr- % it asstst 

you in progfamming the MCS809E 
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:■ 






I 










T3 tf 

- 

li 

: - 

it 



1 



■- 












5 = ?? 



■ - 

■ 

. 

a 
• s 

III 
I'll 



' ki: 
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FIGURE 17- CVCLE-SV^CVCLE PERFORMANCE (Sheet! of St 



LBCC. LKS, l&EQ. LB4JS 
LBGT. LB«I. LbHS. LBLC. 
LBtO, LBLS. L&lT, 
1.BMI, LSNE. LgPi.. 
LBftA. LflRN. ..tjSR 
LSVC. LBVS 







CH'Sf High 


►■-NUN- ':Jl 


I 


QH«1L0" 


MyjN 03' 


I 


O^'iCjie 


= Ff* 



BCC BCS 6EQ. QOE. BO' 
RhS SLE B4.D. fii.S. 9LT 
6*t£ BPL * Ri BF!*j 
34fi. BVt. 9V& 



2 itddrtta NhlNN .J 




t cpcfrfcE- d'-fi h|C|hii{J?iluJ 



Wi 


OtJhiCa'f | 




»« [ 




^e^ 

\lH 


™"\ *«> 






«-y 


I 






Z>fcfi r L-iir 




■it* teti i *» 




1 




Do* i O* 




fFFF 




V 




fteiij'n Addr L^rt 




ilj.J* 




* 




RpI-jmi Add. High 




Wk 




I 





^ 



FIGURE 17 - CYCLE-BY CYCLE PERFORMANCE IShwM 2 of 61 
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FIGURE 1~! CYCLE BY CY'lE PERFORMANCE IShwr 3 of 51 
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FIGURE 17 - CVCLf-BV CVCLE PEFFORMANCE l5he«t*ol5l 
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FIGUflf 17 - CYCLE-BV-CYCLI PERFORMANCE (SheetSotS) 



Mitt Irs* A«IC4? 



l 






^ 



ADDA'S. 
UNOA. ft 
FJlTAJB 
CMFA/B. 
6t*AjFj. 

OflA^ft. 

vjoa e 



| OtHii^i- 



11 



Cc*i>i.iim Qflfrei f 



Mfr{H^I 




^ BU LHrjM 




* (M Oriytl 




IE Bn uilrtii 




AccuriMlJii* OI'K* 


omA 


A W*5>5«pi Liiiw 




6 f*Wtt' OM»i 




[> Icg^H' OiUri 




Ai>ii? liKiemtrtri &ol 


ffn*niH 


nfc.VSir^nr &, f 




Irv'tmwc b, 2 




Oncemtfii t> 1 




p«l***fii or ? 




Caniimi OihM* iram 


PL 



In*-- fljflal* + £flil Sv 1 * ***?• p H4l Svr. 



■"dm ft^gutti - i 






>iig ii># -indw^ri rf(«i 
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TABLE 4 - B-BIT ACCUMULATOR AND MEMORY INSTRUCTIONS 



Mnemonic! »> 


Operation 


ADCA. ADCB 


Add memor* la acEumuletaf wuh car** 


ADDA ADDB 


A :■ ! '■ »-" ■ . ■ ! „it u .i" ■ 


ANDA ANDB 


Arid fnetnorv irVrth sec umula lor 


ASk. ASLA A.SLB 


Arithmetic stiilt of accumulator or tii 1 " 


...-. . .-.- 


.'. '- h »:r„; i,r '• ' .i , .-■ ' ' . ■* 


BIT A BITB 


Bit tei! Fiwmcwv *«tl ICCmfluJOT ' 


CLR. CLRA CLRB 


Clear accumulator af memoir location 


CMPA. CMPB 


Compare memory !(Qm accumulator 


COM COMA :omb 


■lOtpP Of nufliay location 


DAA 


■ A acCUTtluUlllH 


Dl MCA DECB 


' 


ICiRA EOHB 


■.-■-■■ . . \' 


! ■ ;'.- ="i «; 


Exchange H I ymtl hv HI Wt A, B. CC, DPI 


1NC INC*. INCB 


■ rtefrl accumrjlotoi 0* memory I-., fl 


LDA. LDB 


LOBd 1 i r'iLrfV 


L5L. LSLA 


. ii *h.tl lel< acciimtilnloi o* memory loc#Tux 


LSR LSRA L5R8 


Logical sh.lt r.ghi •rxumutalol or memory lotal>r}p 


MUL 


Unsigned mutl .' . * ' S — Dl 


MEG, MEGA. NEGB 


Negato accumulator or memory 


..,._.; i : 


Or memory with accumulator 


ROL. HOLA. ROLB 


Rotate at t umulatar rjr memory let' 


ROH. BORA. ROBB 


Rolele accumulator of memory. 


■ r< - i 


Subtract memory hum accumulator yyylft boftow 


'---. ■ '•:• 


St n i umutat ■ 1 n Bf 


^UBA. SUBB 


accumulator 


TST TSTA. TSTB 


Test ar cumuldTor or memoiv lo si 


JFR fit HI 


rrxufM HI to R2 IR1 "J A B CC. DPI 



:,jr[>P 
PULU 1 ■ 

TABLE & - 



I .(511*0 lu IpuBBd Ireml rather Slack with P5H5. PSHU IPUL S. 
16-BIT ACCUMULATOR AND MEMORY INSTRUCTIONS 



Mnemonics. 


OtwJTwn 


ADOE 


Ado nwrnorf iu D KCumutolCH 


Mi 


Compw ■inefnoFir tform sccumi jjaio* 


£XG D, f* 


Eittftang* LT with X V S U or PC 


LDD 


l.Odd D afCCumuld ro r '' 


stx 


5>Q/i {*"er.: M ft rgiT jtAICH ' 1 ■" ■ 't HdCO« 


STO 


Stare D aEcuTTiymor id momiOfy 


SUED 


SubliaCI TTien"LV> trri-r D AfA arttglalor 


T^R D. H 


rranjt* Dto x. T. S. U o. PC 


■ ." l. ,. ; 


Transfer X r V 5. U .gr ft, iu [J 



NOTf D may be cuiVert Iputall hi •«! er nacfc «m - I - 

PULUl inSiruct<ons 

TABLE 6 - INDEX REGISTER STACK POINTER INSTRUCTIONS 



Initruclron 


DflKnptlon 


CM PS CMPU 


. ► 


CMPx CMPt 


Crrrrt|ujre nvfmory from ith)*., tegisler 


EXGR1 R/ 


EicWnge D * "' S I nr Pt. *itr. 1) . » > i. U ot P( 


1EAS llAu 


L jdd offer ■ ick porntBr 


LbAl UAT 


. ■ ..... ■. 


IDS L3L 


en i , 


LDH. HI* 


load ■ 


PSHS 


Pusn A B CC DP II « < or PC « i*r<f*aft itaci 


PSHU 


Push A. B. CC. DP. K 'f b di PC onfu .j^e 1 5tuc* 


I'ULS 


Pun ft B.CC D* D n V u or PC. (run riArdware st-v » 


Pi.ru. 


DP OUT 1 . ' II Ivnafd '.tact 


STii SIU 


Slnre MAT N pof h r' 1 "I '"' ■- 


■ • . 5 , 


■ . . 


■ , i, „• ... 


ir»nif»i n « ' •". u ■ p; ia D.> v s.u« pc 


AMU 


Aiiu B KxuRHlUltar to < lunvgnMI 
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TABLE 7 BRANCH INSTRUCTIONS 



Inntucttan Dstcneimn 


SIMPLE BRANCHES 


■■■ . LSEO 


1 ffluj' 


B*l 1 SNI 


B"aixr ' ■ . 


BMI l, BMI 


1 riillus 


B»l IRPL 


' plus 


.. 


Btanr.h A cvrt »t 


8C Lfl 


fl'fl^r.* 1 


evs lbvs 


'"!'■' 


BVC LBVC 


-■■ 1 -'. - 




SKjNt:) BRAMCHES 




BGt iBfj' 


fl'di. '■■ ' -g'^jl^- \>,y 1' 1 


BVS LBVS 


Branrri if m v ai,d J $ can t I 


BGf : B i 


■ i ' r gt«SM4 "'ntr 'if 9QU9 


BFCi 1 HI a 


Branch t erjija' 


BM i [>M 


■ ? r>ur trquai 


Hit iBLf 


1 icii Thar» i>» tKjuai 'wgncrji 


Hvr I BVC 


■ ■ , ; tn !■■ I '■ 


BLT LHLT 


■ 1 IBS Irian ijigwcjl 


UNSIGNED BRANCHES 


BHi lBh 


BijN«.i 


Hr.t LBLL 


"LJflWll 


BHS I BHi 


firwich -.■'j'wd* 


HLO LBtQ 


Branch ' i 


BNt LHNE 


Buri't t .....I i^j^ai 




,. ■ 


■■■ 


BIS lBCS 


Brarirr. >l koiNe it,r-vg^J' 


BIO IBLQ 


' f n«*J' 


OTHER BRANCHES 


BSR. LBSB 


BrJ'vch To Su(j' . ■ 


BRA L8RA 


Biflnnh always 


BHM LBHM 


■ ■ 



TABLE B MISCELLANEOUS INSTRUCTIONS 



Inftructon 


DHcnption 






■ dfcfrtH 1 ' COtfe r^giiTfr' 




ftND ctir.tj-i-ur i ijcie fdbjistibi it-.en *,i ■ 1 ■-■ .i 


NOP 


V per*t(Q/ 


• 


IT ..r ,..}+. ■*,j|lV* + 


jMP 


jump 


JSft 


Jump [Q wbrr.iigEinB 


RTI 


•Hi-'i,- l 


JUS 


Aerlum Irum -iuCnoutinfl 


SWl ^Wlrf ^WI3 


^L.ffrftdri? "TM'-..i [ .li 


SvfMC 


Sv"fhrOf*"/e AiTf- n"iltt»«iiPr ime 
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TABLE 9 HEXADECIMAL VALUES OF MACHINE CODES 


OP 


Mil."" 


Mun> 




j 


OP 


Miiflfil 


Mode 




1 


OP 


Mn»m 


Modi 




t 


00 


f-jb i 




B 






• 


II i. .. J 


«. 


- ■ 


60 


1" M 


■ 


6* 


1 • 


111 


• 


1 


I 








LEAY 


t 


4 H 


. 


61 


* 


1 






03 


• 










. 


ItAS 


T 


J 1 




. 


• 










a 


V 






n 










4 • 




M 


COM 






6. 




CM 








1 




11 


■ 




- 


. 


64 


LSB 






' ' 


.•• 


.<■ 


• 










■ 


POLS 






. 




* 










OB 


■ 






6 


2 


I 




' 


: - 




■ 


HOF1 








;- 


.. 


ASH 






6 


; 






ImmtHl 




2 


82 


ASR 






■ 




OB 


ASl.. lit 






6 




38 


■ 








aa 


ASl LSI 








2. 


09 


ROL 






6 




39 


HIS 


■ 


5 


■ 




MM 




6. 


2 * 


OA 


■ 






6 




■ 


ASK 


♦ 


1 


1 


<iA 
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Thfre b.t p<*gistof5 #*> A B 

Thft 16bii regstHf&arB K. V. Id, S D PC 

3 E A is i he effective atjdiess 

4 The PSH and PUL mitnKttiQni paquire h attUn plus 1 eve* 'd^ each bytt pushed c pulkxl 
& &LBt means 5 cvc>» «' branch not take*. 6 cvcH» ii ij*.,*n (Si«ncli if«ruci*on*l 

6 SA'l sets i and F btta SWi? and SWI^ito noi 4«ftct I and F 

7 Conrjit-tms Code* set as a direct resuH of thu instruction 

8 Vaoe o' half ra"> tiatj ■« undefjfhed 

9 Sue^sai Casi- Cjrry set il b7 a SET 



FIGURE IB PROGRAMMING AID I CONTINUED' 



Branch Inttruclion* 
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SIMPLE BRANCHES 






OP 


- 


1 


BRA 








LBRA 








BHN 


.'■ 


i 




LBHN 


10S1 


6 


1 


BSH 


BO 


? 


. 


LBSH 


17 


j 


) 



SIMPLE CONDITIONAL BRANCHES (Noles 1 41 
Til Truo OP Fake OP 

N«! ■' .-! di" 2* 

BEQ .:■ BN£ 26 

V»l BVS 29 8VC 7B 

C-t BCS « BCC 



SIGNED CONDITIONAL BRANCHES INot« I 41 



Ttu# 



OP 



Fatie 



r>m 


BG I 


2t 


B4.E 


!F 


r fcrr 


BGI 


:■ 


Bit 


•■: 




*i 


J' 


BNE 


.i 


rim 


B ■ 


." 


BGT 


. 


r^m 


BIT 


71) 


BCE 


.'■:. 



UNSIGNED CONDITIONAL BRANCHES INaTK 1*1 

lis True OP False OP 

rsm B ' 23 

ijt BHS 74 BLO » 

cm Btij 2/ BNt 

r»m BL^ 23 BHI 22 

r<m BLO 25 BHS 24 



1 All conditional brflnt.lteS Itam bolt* short and iqng variations 

2 AM shon branches are 2 by'os and loqinw 3 cycles 

3 All const" ■ ''*5 aw tormed by prel-ung The shnrT branch opcode wim ill! and using a 16 hit deshhalirv 

4 Alt conditional long branches require* byres and B cycles it The tuanch 4 taken oi h cycles it the branch is rv | 

5 Blfll means b itvtles it brarwh r^al lakan. 6 cycles il I4ken 
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INDEXED ADDRESSING MOPES 



Typ* Forms 


Nondirecl 


Indirect 


Auembler 


Post-Bytv 

Oi,. (Kin 




* 


■v. . ■ : . 
Form 


Post Hvtw 
Othtoda 
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, ,. , , ,■ .«..• : ion i- No Of*sei 
b Bit 

8 Bit 

.... . - 


n »■ 
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■ ■ 


.; 


■i 


A ■■ 


M 
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INOEXLH ADDRESSING POSTBYTE 
REGISTER BIT ASSIGNMENTS 
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6809 PROGRAMMING MODEL 
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6809 Sia». 
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£803 Vectors 
fftt Restart 
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FFFA SIATI 
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PC LO 
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K .... ..... 


'481 010T = PC 






0001 = X 00- 




PoshOtoei 




0010= 1 1001 = 8 
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0011 
101 


- u 
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10 T0 =CCH 
101 1 . DPB 









OROEHING INFORMATION 



Packaot! 




TamptfBlurfr 




Typt 


Frtqutficy 


Hangs 


Order Numtsor 




i VH; 


■ 


■ - ■ ■ ■ 


ft 


1 MHj 


1 ■ ■ 


: ■ 




ISMHi 


' 


■ • . . 




■ 


- «J"C to 86 C 


Mtoe.i ■ ■ 




.'0 MHj 


O'C in 


MC68B09L L 




7 MHI 


we w s& l 


'.1 ...; >■■ 


Pk3Sti£ 


1 Mm 


C tp 70 'C 


... ..,.„,• 




10MH* 


' 


MCWOSfCP 




ISMHi 


OX. 10 70"C 


MC6BA09FP 




■ i i,... 


'n«»C 


MC89A09ECP 






. 


MC8B809EP 






'.. .. MiftVC 


MC68B05HCP 


i. efdtd 


1 .i MHf 


' 'I.-' C 


MCG809ES 


S Sulh. 


1 MHr 


40 C lo 86 T 


■ -i€C5 




1 5 MM7 


' 


MC68A09ES 




liMHr 
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. >9£CS 




2 MMr 


>o'c 


MCnBWMES 




. '.'■•.' 


■•■ M « L 


MUbBHMlCS 



H - rtH PROGRAM 



H* T Ef H program POCSIS I ,c*s listed 

Add sulliik letter* to pan number 

L»v0t l acW S' Level 2 atkt D Uvfll3«M"DS 
r :Jm - i - » ID 1! 

Level? D ■ 166 Hour Burn m ,n »2B*C 

Level 3 "DS = Combuwon ot Lew I 



Appendix 2 
SN74LS783 data sheet 

Supplied courtesy of Motorola Semiconductors. 

The Information here has been carefully checked and Is 
believed to be entirely reliable. However, no 
responsibility Is assumed for Inaccuracies. Motorola 
reserves the right to make changes to any products 
herein to Improve reliability, function or design. 
Motorola does not assume any liability arising out of 
the application or use of any product or circuit 
described herein. No licence Is conveyed under patent 
rights In any form. When this document contains 
Information on a new product, specifications herein are 
subject to change without notice. 
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Advance Information 



SYNCHRONOUS ADDRESS MULTIPLEXER 

The SN74LS783 MC6883 tilings together the MC6809E 
(MPU). the MC6847 (Color Video Display Generator! and dy- 
namic RAM to form a highly effective, compact and cost ef- 
fective computer and display system, 

■ MC68Q9E. MC6800, MC6B01E. MC68000 and MC6847 (VDG! 

Compatible 

• Transparent MPU VDG Refresh 

• HAM size — 4K, 8K, 16K. 32K or 64K Bvtes IDynamic or 

Static) 

• Addressing Range — 96K Bytes 

• Single Crystal Provides All Timing 

• Register Programmable 

VDG Addressing Modes 

VDG Offset 10 to G4K) 

RAM Size 

Page Switch 

MPU Rate (Crystal - 16 or 8) 

MPU Rate (Address Dependent or Independent) 

• System '"Device Selects" Decoded 'On Chip' 

• Timing is Optimized for Standard Dynamic RAMs 

• • SO V Only Operation 

• Easy Synchronization of Multiple SAM Systems 

■ DMA Mode 



SYSTEM BLOCK DIAGRAM 
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TV L>ip.ptl* T S*ClK 
t« Option*' 







swMtsao 
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COLOR 

- ■ (n 



SN74LS783 
MC6883 



SYNCHRONOUS 
ADDRESS 

MULTIPLEXER 



LOW POWER SCHOTTKy 




N SUFFIX 

PLASTIC PACKAGE 

CASE 711 




J SUFFIX 

CERAMIC PACKAGE 

CASE 734 



PIN ASSIGNMENT 


1 C 


A11 


vec 


p 40 


2 C 


A10 


AI2 


t3 3» 


JC 


a>; 


A13 


3 38 


<» c 


.-.', 


A14 


P " 


6 tr 


Oscm 


AtS 


13 36 


e c 


OsCQuI 


Z7 


=1 35 (RASH 


7 tz 


VCIk 


7fi 


=1 34 


8C 


DAO 


ZB 


=1 33 


sc 


KS 


.-■1 


ID 32 


wc 


Wb 


Z3 


=1 31 


it d 


CAS 


za 


=> 30 


17 C 


HASO 


.-■ 


£3 29 


13 C 


a 


H 


Z3 28 


14 C± 


E 


ss 


p 27 


15 C 


ft W 


51 


=3 28 


i6 p 


Ail 


sa 


ID 26 


17 cd 


A- 


A) 


3 24 


ta p 


u 


u 


3 23 


19 C 


A3 


AS 


=1 22 


70C 


Gnd 


M 


Zl 21 











■ > > I .am* .JlfcJ "IJjUtm on * fl«« prod^ft Sp#e >f i C #l«< J ni 1 and injlo<rmatm"> Hertf.n 



* WJTWBiJ) X ,', -<*- 



ADi 595 
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MAXIMUM RATINGS ■ Ta Z5X u"',is other*. le notes I 



Rating 


Symbol 


Vslue 


Unit 


Power Supply Voltage 
Input Voltage If *etrpt Q*ei n f 


vcc 


5 to -TO 


Vdc 


v, 


5:: 


v i.. 


Input Current ffucepl 0« 


'1 


Mllo •id 


mA 


Gutpul Voltage 


wo 


5 1a • 7 


Vdc 


Operating Ambient TempR'aturB Range 


TA 


IS .70 


'C 


Storage Temperature Range 


r M0 


-85 to '150 


c 


Input Voltage Ostein 


l ViOiem 


OS to Vcc 


Vdc 


Input Current Osc m 


l|0«hi 


0.5 10 -50 


■■ A 



RECOMMENDED OPERATING CONDITIONS 



Rating Symbol 


Value 


Unit 


Power Supply Voyage 


v cc 


4 75 10 5 25 


Vdc 


Operating Ambient Temperature Range 


TA 


ii ■.. i: 


C 



DC CHARACTERISTICS ..Unlets, otherwise "ored ipecrficaiionf apply over *et:o tim ended power suuply arid 
temperature range*, p 



Characteristic 


Symbol 


Min 


Typ 


Ms* 


Unit* 


Input Voyage — High Logic State 


VlH 


20 


— 


- 


V 


Input Voltage — Low Logic Slats 


V,l 






OS 


V 


Input Clamp Voltage 

(Vcc " M,r - 'in ■ ■"* mA1 a " Input! Except Oac| n 


VlK 




1.5 


v 


input Current — High Logic State at Max input Voltage 
(V CC " Mai. V in 5.25 Vi VCiK Input 
(V C C Mai. V in - 5.2B Vi DA0 Input 
(Vcc " Ma "- Vin 5 26 VI OscQ ut Input 
IVcc " Max, V^ - 7.0 VI Alt Other inputs Eicept 0»c|„ 


h 


- 


- 


200 

100 
2E0 

•on 


H-A 


Input Current High Logic State 
(Vcc Max. v in * 2 7 VI All Inputs Except VCIk. OlC| n " 


'IH 


_ 





20 


HA 


Input Current — Low Logic State 
(VCC "' Max. Vin * 0.4 VI DA0 Input 
(V C C - Max. V iri ' 0.4 VI VCtk Input 
(Vcc Ma » Vin - 4 V. Ost| n Gndi Olco ut Input 
(Vcc * Mai. V,n " 4 VI All Other Input! Except Otcin 


'IL 


- 


30 


I 2 
50 
B 
J 


mA 


Output Voltage — High Logic State 
(Vcc ' Mm. loH " 1 mA! RAS0, RAS1. CAS. WE 
IVcc Min, Iqh - 2mAI E, Q 
(Vcc ' Mm, l(}H " 0.2 mAI All Other Outputs 


VOHICI 

VOH(El 

VOH 


3.0 

v C c ° 75 
27 


- 


- 


V 


Output Voltage — low Logic State 
IVcc Mm. I 0L = 80 mAI RASQ. RAS1. CAS. WE 
'Vcc _ Min. Tql - 4.0 mAi E. Q Outputs 
IVcc Min. lOL ° B mA l VCIli Output 
IVcc Min, 1q l - 4 mAI All Other Outputs 


VQLICi 
VOUEl 
VOLIVl 

vol 


- 


- 


05 
05 
06 
05 


V 


Power Supply Current 


ice 


— 


180 


230 


mA 


Output Short -Circuit Current 


'os 


30 


- 


22b 


*TlA 



■Including DfCOu) Iwh*" QfCLn «5 flrOur.d»t,t 
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AC CHARACTERISTICS 14 75 V- Vcc" 5 25 V and 0- T A JO C unless gtherny,. 



C ha r*c (Bristle 


Symbol 


Win 


Typ 


Mai 


Units 
ns 


Propagation Delay Times 
(See Circuit in Figure 91 Oscillator In X to Oscillator-Out* 
Oioiltotor-ln > to Oscillasor-Out* 

ICl 136 pF) AOIhru AlStoIO Z1.2JlhiuZT 

iCl 30 pF! AO tnru At!}, ft W to SO SI, S3 

(Cl ' S6 pF) Oscillator-Out ~* to RAi : • 
ICl 95 pF) Oscillator-Out * to BASO *. 
(Cl 95 pFl Oscillator-Out * to RAS! * 
95 pF! Oscillator-Out * to RA51 X 

ICL - 195 pFI Oscillator-Out T» lo C-v- < 
(Cl - 195 pFI Oscillator-Out X to £A5 A. 
ICl 196 oFl OstiNatoi On! « ro WE a 
iCl 196 pF) Oscillator Out * to WE » 

[Cj tOO pFl Oscillator-Out «_ lo E a 

IC)_ 100 pF| OscrllatOf-Oul A lo E * 

ICl, 100 pF) Oscillator -On! * In * 
ICl ■ 100 pFI Oscilletor-Out «.1oQ *. 

iCl 30 pFl Oscillator Out 4 to VUk y 

ICl - SO pPl OscillMor-Oul j loVCHtX 

iCl 195 pfl Oscillator Out * to Row Address 

i Cl 195 pFI Oscillator-Out > to Column Address 

(C L 16 pFI Oscillator-Out -» toOAO 4 Earii«[iti 

|C L - 16 pFi Oscillator Due 4 to DAO * LatestHI 

ICt-SBpF onSAS,C L » 195pFon CAS) CAS *,. to RAS * 


IdlOLOHl 
'dIOH-Oll 


3.0 


- 


'dlA-Zl 
tdlA-Sl 




26 
ID 




'dIOL B0H1 — 

'dlOL-ROLI' - 


20 
IS 




'dlOL-RlHl 
'dIOl-RILl 




22 

10 




'd lOL CHI 

'e||("l CL 




20 


- 




'dIOL WHl 
IdlOLWLl 


1 


- 






'dlOL-EHi 




55 
25 




'*oi -aw 

l(iiOL QL. 




55 




IdlOH VH1 

td(OH-VLi 


_ 


50 
65 




'd(OL-Aftl 
'cilOL-ACI 




36 





IdlOL-DHI 
'dlOL-DHJ 





-16 

• t5 




'dlCl-PJHt 


— 


208 


— 


Setup Time (or A0 thru A 16. R W Rate !6 

Rale - 8 


la .A 




28 
28 


- 


ni 


Hold Time (or A0 thru A15. RW Rate- 16 

Rale 6 


'hlAI 




30 
30 


— 


ns 


Width of HS Low 2 


'wLIHSI 


20 


5.0 


8.0 


»• 



NjjTb* 1 Whan mti^g tha SAM Win m* WC684? !h# njung «dgi n* DAD hi cgi-if ~ n *d Mrtfhkn 1** rand* ihowf> >n ih» Timing rti »g r a m t 

synChrL-in.furg firurcS* it i r»c ernpltfl* i Ths i,yiic h r q n fj*t ton pfOCfrU 'SHijir.w, i nrnjumun. ul 3? CydtH O f OjcQut hr' ccm fH#t t*jn 
2- 'WL-IHS! WHlflJ UhiiTt I? urimvy yield mnr» tti»tr fl ■ i &ci^#ni . a | r#fr»h *d<Jrs*ffti 



FIGURE 1 - PROPAGATION DELAY TIMES 
VERSUS LOAD CAPACITANCE 
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PIN DESCRIPTION TABLE 






Nimg 


Ma. 


Function 








s 
! 

a 

EL 


v cc 


40 


Apply • 5 volts ■ S% SAM d'iwi less thin 230 mA 






Gnd 


20 


Return Ground lor • 5 volts 




Ats 


36 


Most Significant Bit 








A14 


37 












A13 


3B 


MPU address tuts AQ-A15 These 16 signals come directly from the MPU and are used to 








Q 


A12 


39 


directly address up to 64K memory locations or to indirectly address up to 36K memory 








- 


All 


1 


locations iSee pages 17 and IB for memory maps! Each input is approximately equivalent 








C 


AID 

A9 

AB 


2 

3 

4 


10 one iow power Schottky load 








e 
■ 










« 


A7 


24 










* 


A6 


23 








* 


■a 


A5 


22 








E 


< 


M 


21 








3 


D 


A3 


19 








D. 


a. 


A3 


IB 










Al 


17 










A0 


IB 


Least Significant Bit 








RW 


16 


MPU READ or WHITE This signal comes directly from the MPU and dj used to enable writing 












la ih? SAV control r*g Bl*l rjyflimk RAM -.:i |ME and to ■tfctbHl rtcvi: *■ IttUtel #fj 






0»C| n 


5 


Apply 14-31 BIB* MHa crystal and 2 6-30 pF trimmer to ground See page 12 






DAO 


8 


Display Address DAO The primary function of this pin is to input the least significant bit of a 














16-blt video display address. The more significant 16-bits are outputs from an interna' 16-IW < 












counter which is clocked by DAO The secondary function of this pin is to indirectly input the 




L* * 






logic level of the VDG "'FS~' (field synchronisation puisei for vertical video address updating 1 






D c 


Bs 


9 


Horizontal Synchronization The primary function of this pin is to detect the falling edge of I 






> o 






VDG "HS" pulse in order to initiate eight dynamic RAM refresh cycles The secondary f jnction 
is to reset up to 4 least signihcant Oils of the internal video address counter 








VCIk 


7 


VDG Clock. The primary function of this pin is to output a 3 679146 MHz square wave* * to the j 
VDG "Clk" pin The secondary function resets the SAM when this VCIk pin is pulled to logic i 












"D" level, acting as an input. 






OSCQu, 


6 


Apply 1 5 si 1 resistor to 14 31 618* MHi crystal and 33 pF capacitor to ground See pi, i- 12 






52 


25 


Most Significant Sit iDev-ce Select Oils] The binary value of S2. 51. SO selects one ol eight 








H 


El 


26 


"chunks''' ol MPU address space I numbers through 7 1 Varying in length, these "chunks" 






> * 






provide elfinenl memory mapping for ROMs, RAMs. Input Output devices, and MPU Vectors | 






o5 


so 


27 


(Requires 7415 138-type demultiplexer) 
Least Significant Bit 




M 


E 


14 


E lEnable Clcckf "E" and "O" are 90 out of phase and ere both used as MPU clocks for the 












MC6B09E For the MCGBOOand MCC80TE. only F isused E it also used for many MC6B00 I 




«■- 


* o 






peripheral chips 




3 


a 


13 


Q IQuadralure Clock 1 




Z7t 


IF, 


Most Significant Bit 






3 




Ztjt 


34 


First, the least significant address bits from the MPU or "VDG" are presented to Z0 ZS i4K 







w 


Z6' 


33 


n 1 RAMsl or Z0-Z6 I16K ir 1 RAMsl or Z0-Z7 I64K « 1 RAMs) Nnl, the mosl significant 






4 £ 


Z4t 


32 


address bus Irani the MPU or "VDG" are presented ID Z0-Z5 l*K • 1 RAMm or Z0-Z6 








23- 


31 


I1GK i 1 RAMs) or 10-17 i64K K 1 RAMsl Note that for 4K » 1 and 16K I t RAMs. 11 IPm 1 






« 


z?- 


30 


361 is nol needed lor address information. Therefore. Pin 35 Is used lor a second row i 








Zlt 


29 


address select which is labeled IHAS1) 








ZOt 
HASlt 


2& 
36 


L tM S (Hirl cant B 1 




Row Address Strobe One This pulse strobes the least significant 6,7 or 8 address bits into 














dynamic RAMs -n Bank at 






si 


RAS01 


12 


Row Address Strobe Zero. This pulse strobes the least significant 6.7 i>r B address bits into j 




be o 
o 






dynamic RAMs in Bank *0. 




CAS* 


11 


Column Address Strode This pulse strobes the most significant 6.7 or 6 address bits into 1 










dynamic RAMs 








WE* 


10 


Write Enable When low. this pulse enables the MPU 10 write into dynamic RAM 








•14 >'ti*& h 


Hj it 4 1 


mas 3 5'tt&aij Mil/ raJvwision color ftutitaruer other frertuentiH may be used LSea pay- 12 1 
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FIGURE 3- TIMING WAVEFORMS for MPU RATE ■ FAST 
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FK3URE 4 — SAM HI.OCK DIAGRAM 
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SAM BLOCK DIAGRAM DESCRIPTION 

MPU Addresses IA0 - A15I: 

These 16 signals come directly from the MPU and are used to directly address up to 64K memory locations 
(K 1 024k or to indirectly address up to 96K memory locations by using a paging bit "P" (see pages 17 and 
IB for memory m3ps.l Each input is approximately equivalent to one low power Schottky load 

VDG Address Counter (BO - BIS): 

These 16 signals are derived from one input (DAO) which is the least significant bit of the VDG address, Must 
of the counter is simply binary. However, to duplicate the various addressing modes of the MC6847 VDG. 
ADDRESS MODIFIER logic is used. Selected by three vDG -node bits IV2 VI. and V0> from the SAM CONTROL 
REGISTER, eight address modifications are obtained as shown in Figure 5. 

Also, notice that bits B9 BIS may be loaded from bits Frj-FB from the CONTROL REGISTER This allows the 
starting address of the VDG display 10 be offset (in V4K increments! from $0000 lu SFFFF* B9B15 are loaded 
when a VERTICAL PRE-LOAD(VP) pulse is generated. VP goes active (highl when HS from the VDG rises if DAO 
is high {or a high impedance.) This condition should occur only while the TV electron beam is in ysrtical 
blanking and is simply implemented by connecting FS and MS together on the MC6847 The VP oulse diso 
elesrj bits Bl - B8. 

Finally, a HORIZONTAL RESET (HRI pulse may also affect the counter by clearing bits Bl - 83 or Bl - B4 
when HS from the VDG is LOW (see Figure 5. 1 The HR pulse should occur only while the TV electron beam is 
in horizontal blanking. 

In summary. DAO clocks the VDG ADDRESS COUNTER HR initializes the horizontal portion and VP initializes 
the vertical portion of the VDG ADDRESS COUNTER. 

REFresh Address Counter ICO - C6): 

A seven bit binary counter with outputs labeled CO - C6 supplies bursts of eight* sequential adUTe^es 
triggered by a HS high to low transition. Thus, while the TV electron beam is In horizontal blanking, eight 
sequential addresses are accessed. Likewise, the next eight addresses are accessed during the next horizontal 
blanking period, etc. In this manner, all 128 addresses are refreshed in less than 1.1 milliseconds. 

Address Multiplexer: 

Occupying a large portion of the block diagram m Figure 4, is the address multiplexer which outputs bits 
Z0-Z7 las addresses to dynamic RAM's. J Inputs lo the address multiplexer include the VDG address (BO - B151 
the REFresh address ICO- C6> and the MPU address lAO- A1S) or IA0 - A14 plus one paging bii P ) The paging 
bit "P" is onB hit in the SAM CONTROL REGISTER lhal is used in place of A15 when memory map TYpe *0 is 
selected (via the SAM CONTROL REGISTER TV bit I 

Figure 6 shows which inputs are fouled to 20 - Z7 and when the routing occurs relative to one SAM machine 
cycle. Notice that Z7 and RAST share the same pin Z7 is selected if "Ml" in ihe 5AM CONTROL REGISTER IS 
HIGH (Memory size - 64K.I 

Address Decade: 

At the top left of Figure 4. is the Address Decode block. Outputs S2. SI, and SO form a three bit encoded 
binary wordfSi. Thus S may be one of eight values (0 through 7| with each value representing a different range 
of MPU addtesses. (To enable peripheral ROMs or I 0, decode ihe S2. SI. and SO bus into eight seperale 
signals by using a 74LS138, 74LS155 or 74L5156. Notice that S2, SI. and SO are not gated with any liming 
signals such as E or Q.I 

Along wilh Ihe A5 - A15 inputs is Ihe MEMORY MAP TVpe bit (TV ) This bit is soft-programmable (as are all 
16 bits in the SAM CONTROL REGISTER,! and selects one ol two memory maps Memory map #0 is intended 
to be used in systems that are primarily ROM based. Whereas, memory map #1 is intended for a primarily 
RAM based system wrlh 64K contiguous RAM locations Iminus 256 locations. 1 The various meanings of S2, SI, 
SO are tabulated in Figure 16 (page 19i and again on pages 17 and 18. 

in addition to S2. SI, and SO outputs is a decode of SFFCO through SFFDF which, when gated with E and 
R W. results in the write strobe for the SAM CONTROL REGISTER 

SAM Control Register 
As shown in Figure 4, the CONTROL REGISTER has 16 "outputs" 
VDG Addressing Modes: V2, V1.V0 MPU Rale Rl. RO 

VDG Address OFFset F6, FS. F4, F3. F2. F1, FQ Memory Size (RAMI Ml, MO 

32K Page Switch: P Memory Map TYpe TY 

When ihe SAM is reset (see page 10,1 all 16 bits are cleared. To set any one of these 16 bits, the MPU simply 
writes to a unique" odd address (within SFFC1 through IFFOF.i To clear any one of these 16 hits the MPU 

' It lis '* held Irjw lDng#i Inah s hi (hen The n.imbei el lequentiil eddifsftui in tine lefilih BURST" it piogiuilinnal |g The limp inTfervil 
(Wing which HS i* low 
" See pages 1/ or T8 for ipwc.fie eddresiei 
1 In liiia document, the J lymtiol nwivi preceea* fctnOcime! chtiictert 
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simply writes to a unique" (van address (within SFFCO through SFFDE.I Note that the data on the MPU data 
jus is ;rravelant. 

Inputs to the control register include A4. A3. A2. Al (which are used to select which cm of 16 bits is to be 
cleared or sell, AO (which determines the polarity . clear or set.] and P W, F and SFFCO - SFFDF Iwhich 
restrict the method, timing and addresses lor changing one of the 16 bits .1 For more detailed descriptions of 
the purposes of the 16 control bits, refer to related sections in the BLOCK DIAGRAM DESCRIPTION (pages 8 
through 12) and the PROGRAMMING GUIDE [pages 14 through 1BI 

■* Sefl Paget Iter le toi toecilic iddrnte* 
FIGURE 5 — VDG ADDRESS MODIFIER 
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FIGURE 8 — SIGNAL ROUTING for ADDRESS MULTIPLEXER 
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Internal Reset 

By lowering Vcc below 0,6 volts for at least one millisecond, a complete SAM reset is initiated and is 
completed within 500 nanoseconds after V££ rises above 4.25 volts 

NOTE- In some applications, (for example, multiple "VDG-RAM" systems controlled by a single MPUi 
multiple SAM ICs can be synchronised as follows 

• Drive all SAM'S from one external oscillator 

• Stop external oscillator. 

• Lower V<;c below 0.6 volts for at least 1.0 millisecond. 

• Raise Vqq to 5.0 volts. 

• Start external oscillator 

e Wait at least 500 nanoseconds. 
Now, the "E " clocks from all SAMs should be m-phase. 

External Reset 

When the VCIk pin on SAM is forced below 0.B vo'ts for at least eight cycles of "oscillator-out", thp SAM 
becomes partially reset. That is, alt bits in the SAM control register are cleared However, signals such as RAS. 
CAS, WE. E or Q are not stopped tas they are with an internal resetl. since the SAM must maintain dynamic 
RAM refresh even during this external reset period. 

Figure 7 shows how VCIk can be pulled low through diode 01 when node "A" is tow.' When node JI A r ' is 
high, only the backbiased capacitance of diode D1 loads the 3.58 MH? on VCIk Diode D2 helps discharge CI 
IPower-on-Reset capacitorl when power is turned off. Diode D3 allows the MPU reset time constant R2C2 to 
be greater than the SAM reset time constant. Thereby, ensuring release of the SAM reset prior to attempting 
to program the SAM control register. 



FtGURE 7 - EXTERNAL RESET CIRCUITRY 




m ■■•">: 



v .-?,., j I 
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VDG Synchronization 

In order for the VDG and MPU to share the same dynamic RAM (see page 13.) the VDG clock must be stopped 
until iho VOG data fetch and MPU data fetch are synchronized as shown in Figure 12. Once synchronised, the 
VDG clock resumes its 3.579545 MH* rate and is not stopped again unless an extreme temperature change lor 
SAM resell occurs. When stopped, the VDG clock remains stopped for no more then 32 Oscq^ cycles 'ap- 
proximately 2 microseconds.) 

In the block diagram in Figure 4. DA0 enters a block labeled VDG Timing Error Detector. If DA0 iIsrs between 
time reference points'* t^ and tq, then Error is high and VCIk is the result of dividing BOSC (Buffered Oscout 

14 MHi! by four However, il DAO rises outside the time Window t/v io *C- ,nen Error goes LOW and the VDG 
stops A START pulse at time reference point tq (center of Window! restarts the VDG . properly synchronised. 



*Uifl i mod* w>lh suHicrontly low forward voltage drop to rriaat y iL raqmranianf at VCIk 
"5*e Timing d-ag'atu on page S and S 
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Changing the MPU Rate (by changing SAM control reg«sier bits RO. Rl f. 

Two bits m (he SAM control register determine the period of both "E" and "Q" MPU clocks Three r ate modes 
are implemented; as follows 



RATE MODE Rt RO 



The frequency of "£" land "Q"] *s f crystal 16. Tn-s rate mode n automahcaliy selected when 
the SAM is reset Note tnai system timing is least critical n this 'SLOW rate mode 



AD. 1 

(Address Dependent! 



The frequency of "E" land "Q"h is ertner ! crystal 
ihe MPU is presenting 



16 or f crystal B depending an the address 



The frequency of "E" (end "Q "I is f crystal * This ■ * accomplished by stealing (he time that 
i* normally used fot VOG REFRESH and using this time fo' the MPU Note Neithei VOG display 
nor dynamic BAM refresh are available in the "FAST 1 ' rale mode (Both are available »n SLOW 
and AD rate modes! 



When changing between any two of the three rate modes, the following procedures must be followed to 
ensure thai MPU timing specifications are met: 



RATE MODE 



SLOW 
AD 



FAST 



^ 



Sel RO 



«^S»1 HI P 



■t ~z 



ap— Sequence #1 



iSee Below! 
Sei RO. then CLEAR Rl 



This direct pain i* f 

_ not allowed except by ■ 



May be ANY address from 40000 i u J7FFF 

SEQUENCE *1 

70 00 00 TST #$0OQ0 - Synchronizes STA instruction to write durma T2-TG tSee Figure #81 * 

21 00 BRN 00 

B7 FF D6 STA #SFFD6 Clears bn R0 

'Nolft "TST' instruction Affect I MC&&39E condition COda regitfv 

Changing the MPU Rate lln Address Dependent Mode) 

When the SAM controf register bits "Rl". and "R0" are programmed to JJ J ' and "V , respectively, the 
Address Dependent Rate Mode is selected. In this mode, ihe 16 MPU rate Is automatically used when 
addressing within S000D to S7FFF* or SFF00 to SFFlF ranges Otherwise Ihe - 8 MPU rate is automatically 
used. (Refer to Figure B for sample "E" and ,r Q" waveforms yielding - 8 to - 16 end - 16 to - 8 rate 
changesK This mode often nearly doubles the MPU throughput while still providing transparent VDG and 
dynamic, RAM refresh functions. For example, since much of ihe MPU's time may be spent performing 
internal MPU functions (address - SFFFFI", accessing ROM (address ■ $3000 to JFEFF) or accessing I 
(address - $FF20 — SFF5F). the faster f crystal - B MPU rate may be used much o? the time. 

Note The VOG op»r#l*> normally «lwn unrig th» SLOW or A ran* tiodRi How***', in ihe FAST rite mad*, TnR VOG i» nol allowed ■ trail to 
(he dynamic RAM 



FIGURE I 



HATE CHANGE E AND Q WAVEFORMS 




"slow' address defected here 



foat address detected here 



"WtlRP UKng Mfmnr, M#fi 0. I'ddr*:sl«4 Sdi>LlC Ifi S7FFF miy *£CR5* Ovn#.TH£, RAM 

■'■TTue MCteCO nulpvH *FF FF nn A0-A1* when no mUri va nri »U4i**iftt Art U*in B prntniM] 
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Oscillator 

In Figure 4, an amplifier between Osc| n and OscQ ut provides thy gain for oscillation lu&ing a crystal as sho^n 
in i mjre 9.1 Alternately. Pin 5 IOsc| rl ! may DC grounded while Pin S (Oscq u) ) may be driven at low-power 
Scdottky levels as shown in Figure 10. Also, see V|h. Vil on page 2 
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FIGUflE 9 — CRYSTAL OSCILLATOR 
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FIGURE IB — TTL CLOCK INPUT 
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THEORY OF OPERATION 

Video or No Video 

Although ! he MC6863 may be used as a dynan m RAM without a vi:«- i " most applications 

are likely to include a MC6847 verier, dttplat gene' ■ I i sizes VC6883 
with MC<5847 systems 

Shared RAM (with interleaved DMA1 

To minimize the number of HAM and intetface ch'ps hi-tr- (he MPLi -ano VDG sh.ire common dynamic RAM 
Vet. the use of common RAM create* an apparent rtifnci fly ""'at 15 the MPU and VDG must both sea 
RAM wthoul contention Titis difficulty is overcome fcrtj Idk ny advantage of the timing and architecture of 
Motorola MPUs (MC6800. MC6801E. MC6809E, MC680Q0' Specifically, all MPu accesses of external memory 
always occur in the letter half ot the machine cycle, as shown beh n 

FIGURE It - MOTOROLA MPU TIMING 

One Machine Cycle 



■E' Clock -1 
lApprox 1 MH11 L 



'V , 'S-* 



MPU Addresf MPU Dan MPU Address MPU Data 

Window Window 



Similarly, the MC6847 toon interlaced! VDG transfers a data byte in a half machine cycle IE or*2l. Thus, 
when properly positioned, VDG and MPU RAM accesses interleave without contention as shown below 



FIGURE 12 - MOTOROLA MPU WITH VDG TIMING 



VDG Data unr VDG Date 

Wmdow mQ Address window 



E p Clock _. 
{Appro* T MHzl [_ 



MPU Address 



This Interleaved Direct Memory Access (IDMA'i is synchronized via the MC6S83 by centering the VDG data 
window half-way between MPU data windows ** 

The result is a shared RAM system without MPU VDG RAM access contention, with both MPU and VDG 
running uninterrupted at normal operating speed, each transparent to the other. 

RAM Refresh 

Dynamic RAM refresh is accomplished by accessing eight"*" sequential addresses every 64' ■ ■ microseconds 
until 128 consecutive addresses have been accessed. To avoid RAM access contention between REFRESH and 
MPU, each of Ihe 128 refresh accesses occupies the "VDG half" of the inlerleaved DMA (IDMA). Furthermore, 
refresh accesses occur only during the television retrace period (at which time the VDG doesn't need to access 
RAMI, 

In summary, the VDG. MPU and MC6883's Refresh Counter all transparently access the common dynamic 
RAM without contention or interruption. 

Why IDMA? 

Use of the interleaved direct memory access results in fast modification to variable portions of display RAM. 
by the MPU, without any distracting flashes on the screen Idue io RAM access contention.) In addition, the 
MPU is not slowed down nor slopped by the MC6883. thereby, assuring accurate software timing loops without 
costly additional hardware timers. Furthermore, additional hardware and software to give "access permission" 
to the MPU is eliminated since the MPU may access RAM at any time. 



* Only 1 pir* fDAOl out lit 40 pint it dedi telnet 10 Iht v ,daa 01 split 

* Sea VPG lYirr"orw#non Ipefl* tOJ tor mort <*»IJil 

* wnen noi using e MC6M7 MS mey be wired law Tor tonnnuotis iTinipartnt rehash 
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"Systems On Silicon" Concept 

Total Timing 

For most applications* the SAM can supply complete system hming from its on chip precision 14 31818 MHz 
nscilrator. This includes buffered MPU clocks 'E and 01, VDG clock, color surv.arnqr |3.bB MHz), row address 
select iRASI, column address select (CASl and write enable IVVEi 

Total Address Decode 

For most applications, the SAM plus a "1 of 8 decoder" chip complelely decodes I O ROM and RAM chip 
selects without wasting memory address space and without needlessly chopping-up contiguous address space 
Chip selects are positioned in address space to allow thtee types Qt memory (RAM, local ROM and cartridge 
ROMI independent room for growth. For example, RAM mav grow from address SOOOO-up. cartridge ROM may 
grow frpm address SFEFF-down and local ROM may grow from SFBFF-down Alternately, if the application 
requires minimum ROM and maximum contiguous RAM a second choice of two memory maps pieces RAM 
from $0000 10 SFEFF (See pages 17 and 18.) 

In both memory maps all I 0. MPU vectors. SAM control registers, and some reserved address spaces are 
efficiently contained between addresses SFFOO and SFFFF 

How Much BAM? 
Using nine SAM pins IZ0 - Z7 and RASOl the following combinations require no additional address logic, 

FIGURE 13 - RAM CONFIGURATIONS 
Address Chip Select 

MSB LSB 

Z&Z4Z322Z1Z0 

Z5Z4Z3Z2ZIZ0 RASi I Z?[\ ' " - One or two bsnks of 4K x B (like MCM40Z7S) 

Z625Z4Z3Z2Z1Z0 RAS0 / 

Z6Z5Z4Z3Z2Z1Z0 RAS1 ( Z7I j ~ ~ " " - - Omj or Iwo banks OF 16K x a ll.ke MCM41 16'li 
Z7ZfjZ5Z4Z3Z2Z1Z0 . . ,RAS0 Que bank of 64K « 8 (like MCM6665sl 



. RASD I 
RASi I Z?l>," 



PHOGFIAMMING GUIDE 

SAM — Programmability 

The SAM contains a 16-bit controt register which allows the MC6B09E to program the SAM for the following 
options: 

VDG Addressing Mode 3-biis 

VDG Address Offset , 7-bits 

32K Page Switch 1-bit 

MPU Rate 2-bits 

Memory Size -. Z-bits 

Map Type 1-bit 

Note that when the SAM is reset by firs! applying power or by manual hardware reset,! all control register 
bits are cleared (to a logic "0"). 

VDG Addressing Mode 

Three bits (VZ. VI. V0) control the sequence ot DISPLAY ADDRESSES generated by the SAM iwhich are used 
to scan dynamic RAM for video information) For example, if you wish to display Dynamic RAM data as 
INTERNAL ALPHANUMERICS VIDEO, you should program* the MC6847 lor the INTERNAL ALPHANUMERICS 
MODE and CLEAR BITS VZ. VI and V0 in the SAM The table on the following page summarizes the available 
modes" 

i S#fr Figure J for manual resfll cirtij 9 

■ TvO'i'allv. part of ft PIA IMC&821I ftl loconon SfF?? uj used IP conrrnl MCSBftf motfet FSfln MC6S47 Dan Sheel I 
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Mode Type 
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VDG Address Offset 

Spvfn b Ts (F6. F5, F4 r F3 r f-2. Fl and F0 1 determmf the Starting Address to* Thi video display The 
"'Starting Address i* defined a* "the addr**;, corresponding to drit? dtspltfysd n trip Upper Left "-rsroer o' 
the TV screen Fhi | Address »s shown beiovs i n binary 



FS F5 " Fj " n | 



Ft Fo" 



I 



jj ; 



BM 



J 



Leal! 
B.I 



Note that the "Stalling Addres-j' may be placed anywhere u* '<■ i :he 64X ■Dtttesi n i ■. ■• . i unon nl 

VjK Itlie w« ot one aiphanurnenc pdqei 

The F6-F-0 bits la^f- a "■ i I ! ''i0 the TV vertical SYmnrorw.., 1 ©n pulse i Atnei : - : > ',' . ■ s oa' 

Page Switch 

One bit (PT> is used "in place of" A15:from the MC6803F in order It* refer accost vwl i t 

o* iwu 32K byte pages ol R^M i' lh^svuem rioes not ■■■ ■ 21 - ot RAM. PI can be 



-■ !. Wtf *4000SEF/f aird UOOC f(H 
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MPU Rate 

Two bits (HI, HOI control the dock rate to the MC6809E MPU. The options are 



HATE I FREQUENCY Of "E" CLOCK I 



0,9 MH2 (Crystal Frequency ^ 16) Slow 
0.3/1-3 MHf (Address Dependent Raief 
1,6 Mm (Crystal Frequency -r 8) Fast 



(Typical Crystal Frequency = 1*31818 MHi] 



In the "address dependent rate" mode, accesses to SQ000-I7FFF and SFFQ0-$FF1F are slowed 10 0.9 MHi 
{crystal frequency ^ 16) and all other addresses are accessed at 1.8 MHi (crystal frequency ~ 8.} 

Memory Size 

Two bits iM1 and MOt determine RAM memory si^e. Tne optrons are: 



SIZE 


Ml 


MO 


One or two banks of 4K * 1 dynamic RAMs 
One or two banks of 16K < 1 dynamic RAMs 
One bank of 64K * 1 dynamic RAMs 

Up (o 64K static RAM" 




1 
1 



1 



1 



■flflcujir-et a laich tor dflrnuitiplexirtg ihe Ham address. 

IMPORTANT! 

Note: Be sure to program the SAM for the correct memory size before using RAM (i e., for a subroutine 
stack I 

Map Type 

One bit (TY| is used lo select between two memory map configurations. 

Refer to pages 17 r 18 and 19 for details. When using Map Type "TY - 1", only the Slow" MPU rate may 
be used. Future versions of the SAM may allow use of all rates. 



Writing To The SAM Control Register 

Any bit in the control register (CR) may be set by writing to a specific unique address. Each bit has two unique 
addresses . . . writing to the even # address clears the bit and writing to the odd * address seta the bit. (Data 
on (he data bus is irrelevant in this procedure.) The specific addresses are tabulated on pages 17 and 18, 

If desired, a short routine may be written to program the SAM CR "a word at a time". For example, the 
following routine copies jr B" bils from "A" register to SAM CR addresses beginning with address r X". 



SAM1 


46 




H0R 


A 




24 


06 


BCC 


SAM2 




30 


91 


(NX 


(LEAXI.Xt 




A7 


SO 


STA 


o.x- 




20 


02 


BRA 


SAM3 


sam: ' 


A7 


81 


STA 


0,x- 


SAM3 


5A 




DEC 


S 




26 


F2 


BNE 


SAM1 




33 




STS 





c 



"t — r 



} 
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FIGURE 14 — MEMORY MAP ITYPE • Ol 
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FIGURE IS - MEMORY MAP (TYPE #11 
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FIGURE 16 - MEMORY ALLOCATION TABLE 

Also see the memory MAPs on pages 17 arid \S.i 



Typt # 0: (Prpmar>ly *o>" POM based systems! 



Address Ring. 


S-4IS2I+2 
IS1I+S0 
8 Value 


Intended Ui* 


J"r: , FFFF 
FFEOto FFF1 
FFCO to FFDF 
FF60 to FFBF 
FF40 to FF6F 
FF20to FF3F 
FFOOto FMF 
COOO td FEFF 
AOCO to BFFF 

BOOO lo BFFF 
0000 to 7FFF 


I 
2 

! 

6 
E 
4 
3 

2 

1 

if Ft VV ' 
7 if R W 


MC6809E Vectors Beset , NMI, BWI. fRQ. FIBO, SWIZ. SWI3 

Reserved tar future MPLf enhancements. 

SAM Control Register VO. V2, FO FS. P. BO. Bl. MO Ml. TV 

Reserved for future control register enhancement* 

1 02 Input Output 1 PI As. ACIAs. etc. 1 Td subdivide, use AC Afl 

1 Ot Input Output [PIAs. ACIAs. etc ! To subdivide use AD - Ad 

1 Op ,n B"< Output IPIAs. A CI As. etc | To subdivide, use AD A4 

ROM2 16K addresses Externa! cartridge ROM" 

HOM1 8K addresses, internal ROM* Note that MC6I09E vector addresses seiact (tut 

BOM- 

ROMO 8K. addresses Interna: BOM* 

BAM: 32K addresses BAM shared Dv MP J and VDG 



*Mol resti'Cled to HO*J f u* »*amDlB. BAM o* I ni*v b* ui»d rieie 



Tvp. » 1 
I 



iPrimaT'iy * tii BAM Lased systems! 



Address Range 



SFFF2 to FFFF 
FFgOlo FFF' 
FFCO to FFDf 
FF60 to FFBF 
FF40 to FFBF 
FF20 to FF3F 
FFOOto FFtF 
0000 to FEFF 



5-4<S2l*2 
.511* SO 
5 Value 

i 

2 I 

7 
7 

B 

t 

4_ 

.( B IrV - 



imtndtd Use 



MCfiBtlSE Vector* Reset NMI, SYVI IRC. FIBO. SVVI2, SVVI3 

Reserved for future MPLJ enhancements 

SAM Control People' VO V2. FO F 6 . P Be R1 MO, Ml. TV 

Smalt BOM Bool load program and initio! MC6809 vectors. 

: 02 Input Output IPIAs. AC.As ftte I To subdivide, use A0-A4 

| Oi Input Output 'PIAs ACIAs. etc J To subdivide a,e AQ A4 

I On,: Input Output ,PAs ACIAs etc I To subdivide, use A2 A4 

RAM_64Ki 7HJ addresses shared h, MPU and VDG 

<HBW - OthenS 3 lor $f too. (FEFF S 2 tor SAQOQ-SBFFF. 5 

SS000 S9F-F a-'d S ■ for WOCiu 15FFF I 
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APPENDIX A 



VDG SAM Video Display 

Paul 
There are three new modes created when the VDG 
and SAM ere used together in a video display sys- 
tem. These modes offer alphanumeric compatibility 
with 8 color low-to-high resolution graphtcs, 
G4H*64V f 64H*96V. B4HM92V. The new modes SB. 
StZ, and 524 are created by placing the VDG in the 
Alpha internal mode and having the SAM in a ?K. 
3K or 6K full color graphics mods. In all modes the 
VDG's S-A and Inv. pins ere connected io data bits 
DD7 and DD& to aJlawswltch-ng on the fly between 
Alpha and Seriographies and between inverted 
and non-inverted alpha. This method is used in 
most VDG systems to obtain maximum flexibility 
The three modes divide the standard BM2 dot box 
used by the VDG for the standard alpha and semi- 
graphics modes into eight 4*3 dot boxes for the SB 
mode, twelve 4*2 dot boxes for the S12 mode, and 
twenty-four 4'1 dol boxes for the S24 mode. Figure 
17 shows the arrangement of these boxes. One byte 
is needed to control two horizontally consecutive 
boxes. It therefore lakes four bytes for the SB. six 
bytes for the S12, and 12 bytes for the $24 mode to 
control the entire 8*12 dot box. These two horizon- 
tally consecutive boxes have four combinations of 
luminance controlled by bits BO - B3. For conven- 



System Offers 3 New Modes 

hv 
Fteicher 

ience B2 should be made equal to BO and 93 should 
be made equal to St. This eliminates a screen place- 
ment problem which would cause other codes to 
change patterns when moved vertically on the 
screen. The illuminated boxes can be one of eight 
colors which are controlled by B4 - B6 (see Figure 
181. The bytes needed to control ail the boxes in the 
8" 12 dot box must be spaced 32 address spaces 
apart in the display RAM because of the addressing 
scheme Orginally used m the VDG and duplicated 
by the SAM, This means to place an alphanumeric 
character on the TV screen it requires 4, 6. or 12 
bytes depending on the mode used. These bytes are 
placed 32 memory locations apart in the display 
HAM fsee Figure IS). This mu.rrpfe byte formal al- 
lows the mixing of character rows of different char- 
acters in the same 8*12 dot box creating new char- 
acters and symbols. It also allows overljning and 
underlining in eight colors by switching to semi- 
graphics at the correct time. 

These new modes optimize the memory versus 
screen density tradeoffs for RF performance on 
color TVs. This could make them the most versatile 
of all the modes depending on the users creativity 
and the software sophistication. 



APPENDIX B 
Memory Decode for MAP TYPE = 1" 
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FIGURE t7 - DISPLAY MODES S8. SI 2. 524 
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Address Byte 
SXXQDIS011 
JXX20 ($01! 
JXX40 (SOD I 



SOI .stha 
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FIGURE 20 — EQUIVALENT OF OSCILLATOR INPUT AND OUTPUT 
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FIGURE 22 - VCik INPUT OUTPUT 




FIGURE 23 - 6 AND O OUTPUTS 
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FIGURE 24 — TYPICAL INPUT 
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FIGURE 25 - TYPICAL OUTPUT 
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Appendix 3 
MC6847 data sheet 

Supplied courtesy of Motorola Semiconductors. 

The Information here has been carefully checked and Is 
believed to be entirely reliable. However, no 
responsibility Is assumed for Inaccuracies. Motorola 
reserves the right to make changes to any products 
herein to Improve reliability, function or design. 
Motorola does not assume any liability arising out of 
the application or use of any product or circuit 
described herein. No licence Is conveyed under patent 
rights In any form. When this document contains 
Information on a new product, specifications herein are 
subject to change without notice. 
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\ MOTOROLA 

\f * \J Semiconductors 

Colvtlles Road, Kelvin Estate - East KiU»l<te/Qa*eow - SCOTLAND 



Advance Information 



VIDEO DISPLAY GENERATOR (VDGJ 

The Motorola MC6847 Video Display Generator [VDGJ provides 
d means of interfacing the Motorola M68CfO microprocessor Family 
{nr similar products) to a commercially available color or black and 
white television receiver, Applications of the VOG include video 
games, bioendj nee ring displays, education, communications and any 
place graphics are ret ]. i 

The VOG reads data from memory and produces a composite 
video signal which will allow the generation of alphanumeric or 
graphic displays The generated composite video may be up modu- 
lated to either Channel 3 or 4 by using the compatible MCT372 iTV 
Chroma and Video modulator). The up modulated signal if suitably 
fof application to the antenna of a coTor TV A typical TV flame is 
indicated in Figure 1. 

• Generates four different alphanumeric display modes and eighl 
graphic display mndei 

• Compatible with the M6800 family 

• Compatible with the MC1372 modulator 

• The alphanumeric modes display 32 characters ppr dw hy 16 

lines 

• An internal multiplexer allows the use of eilher the internal ROM 
or an external character generator 

• An external character generator can be used to extend the in- 
ternal character set for "limited graphic' 1 shapes 

• A Mask Programmable pnternaf character generator ROM is avail 
able on special order (Appendix A) 

• One display mode offers 8-color 64 * 32 density graphics In an 
alphanumeric display mode 

• One display mode offers 4-color 64 * 48 density graphics in an 
alphanumeric display mode 

• All alphanumeric modes have a selectable video inverse 

• Generates full video signal 

• Generates R-Y and BY signals for external color modulator 

• Full-graphic modes of fet 64 * 64. 128 x 64, 128 x 96, 128 k 192, 
or 256 x 192 densities 

• F ull graphic modes allow 2^olor or 4-color data structures 

• Full-graphic modes use one of two 4-color sets or one of two 
2-color sets 

• Available m either an interlace mode (NTSC Standard) or a non 
inurtaca modi 
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FIGURE t BLOCK DIAGRAM OF USE OF THE VDG IN A fV GAME 



A.]nr*n Fl.jv 



X7 



Mnemonic hnNumbvi 

Vex 1 > 

Vss I 

CLK 33 

QAODA12 72.23. 24. 26. 26 

13. 14, 15. 16, IS, 19. 20. 21 

DD0DD5 3. 4, 5. 6. 7. 8 

DD6 OD7 2.40 



H-A, ^B, V 


11. 10,18 


CHH 


9 


Hf 


16 


,:' 


>: 


■ N ■: 


32 


IMT/EXT 


.-:' 


A S 


14 


vt, 


12 


A 1 


M 


t ! 


3? 


CSS 


j!l 



! ir-f. ! ii.. . M 









n 



Bum ^ 



t t t 



II 



0M&GM3 30.29.27 



Funtiun 

♦6V 

Ground 

Addieil lints to dqplaY memory, hrfjh i mpedanc e during *rmmi»v *rl#er (MS) 

Did Irom display memory RAM OF ROM 

Data from display memory "l graph re mndi» L data alto in alpha ncismal mode: color data in 

Alpha «nn graphic 4 or 6 

CKrornmonco and I urn inarm* enakig [R-Y. B-Y. V] output to RF nvadulator (MO 3 72 i 

Chroma bias, relerenca &A And &B Itvtts 

Rwd [ i r h- ip- r Oulpul >" urovrde iinmnfl tor fjTMflial charaCTP' ™«"l*Tjror 

Howpnta! SyoC Output to pruvide liming lor external character gene.nlcir 

Invert* wefne m. all alpha moota 

Switches iq external HQM in tfpha mode And Kiernwen SEMlG-4 and SEMIG-G >n 

■ .graphics: tol«Ch betnw&ri alpha and vnn igraph iC s in alpha mode 
Memory SrMcl force* VE>G address thi'fefs to tugh- 1 mpedanee stBt* 
Switches htrtiAnevn alpha and graphic modes 

Fn»ld Synchroni/at4on goes low at boirom of aclwe display ar»a. 

Coloi *et »k#ci; UrPents between IWo alpha display Cofon tlf between two COfpr sell if» 
ufmigraphic% 6 and full graphs* 
Graphic mptte t*Mtct, select one of noni graphic modes. 
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FOftMAI Of THE TELEVISION SCREt* 



ELECTRICAL SPECIFICATIONS 



ABSOLUTE MAXIMUM RATINGS 



(fvfag 


V*lu* 


Sunpiv Votap iVfsrfl 


0.3 1 ■ ' -I. 


Input Vo.lt*i)P *>v Pin 


n i -■■■ ' ! n\ 


Opernirtg T(mper»t(jin 


DC Ui 'CTC 


Sto"*]Hf Tpfriperfltuie 


«5C io 190*0 


! 1 nn [w ! -on 


the 




■ 






■ 

i utT (ml 
Ol"-" <J*B i IKU'l 



o 

O 

si 

o 



■On* ar> p« n e-nri , 



DC ISTATICI CHARACTERISTICS - rv cc sovsuvfe 


CO V. T A = O^C to T0°C 


unlet* otherwise noted! 




Cherecttmie 


Bvmbta' 


Mm 


Typ 


Man. 


Unit 


Input H*ah Vn?r.age 
Clk 
Other Inpurt 


V| H 


Vss * 2* 
Vss * 2 




vcc 
vcc 


Vot 


Input Low Voltage 
Clk 
Other InpuSi 


V,L 


V SE - 3 
Vss -0.3 




Vss * 4 
Vjs ♦ o* 


V* 


Input Leakage Current 

CLK. GM0GM3. INV. INT .EXT. MS.Vss. DDQDD7. A/S. A7G 


'in 






2 5 


uAtfc 


Three-Slate lOfl Statel Input Cuneni DA0DA12 


!|XI 






10 


*Adc 


Ohtput High Voita je RP. Hs. FS 

•Ccoad 30i)F. l Lald * -IOOuAI 


VOH 


3 4 






Vdc 


Oulpul High Voltage DAODAi: 
tc Loed" 55 OF. 'Load' -100 .Al 


VOH 


M 






V* 


Output Load Voltage Ftp HS. FS 
^Load" 30pJ=. iLoafl" 'BrnAI 


vol 






Vjs * °4 


Vdc 


Output Lpw Voltage DAD-DA12 
'CLoaei* 56 pF. l Loid I.SmAI 


•-.. 






V S S ' 4 


". i. 


Output High Curt ant (5uureingl All Output* ■except 
iV OH 2.4 V! >A . S. V, 4CHBI 


'OH 


-■ , . 






•Adc 


Output Low Current (Sinking] Air Output) lexcep! 
IVol ' 0.4 Vtfcl sA. oB. Y. SCHBI 


'OL 


1 6 






mAdc 


Input Capacitance All Inpuii 
IV,„ - C.Ta • 26°C. r ■ I.OMrltJ 


Cm, 






7 5 


pF 


Chroma Slat Voltage 

IC L o*d »20pF, Ft Load - 200 k ohm. V cc • 4 75- 6 25 VI 


Vr 




0.3 v cc 




Vdc 
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DC (STATIC! CHARACTERISTICS - iw cc - &.0 V • '. V& imv, T A 


0°C to 70°C unlet* ottretwivr noted! 




Charactarisuc 


Symbol 


Mm 


Typ. 


Mat 


Unit 


Chrhmo ' A Volfapo Fi^nj 7 
ICLoiRi " 20 pF. H Liwa - 200 k ohm 1 


v CiA 

Vhi 

V L0 




V H • 1 V CC 

V R 
Vr - 1 V CC 




Vot 


CHrnnu >,''B Voltfrga 

l c Lo«1 - !0 l'F, Usui 200 k oh ml 

v 

V L0 


V| | 




V„ ■ 1 v C t: 

VR 
Vr -0 05V CC 
V H -0! V cc 




v 


Luminance V Voltage Fiyure 2 

'Cl ...i -■■ i - 'Viua -'200kohml 


Vy 

Vs 

V BLANK 
v Bt.ACK 




0?V CC 
75 V s 
0,7 V S 




Vdc 


Vol Taoe Wh lift Luwi Finu'e? 
(Valued White Mudiuml 
1 Voltage While High) 


VWL 




63 V s 

osv s 

38 V S 




Vdt 



AC (Dynamicl CHARACTERISTICS "Vcc 5.0 V t b*. T A - 0°C lo BWC 



ChirKldriltiC 


Symbol 


Min 


Tya. 


Km 


Unit 


Clk Frequency 


' 


n :■.■'!>•:«, 


3 579645 


3 579555 


MHz 


Clk Duty Cycle 


Ok lfc 


45* 


MS 


bbf, 




Chroma PhjKt Delay Figure 3fJ 










fit 


Ifneasured with reipect io"'Y" oulnutl 












<aA 


<VA 




KKI 






t 


'VB 




10C 






Luminance Rise Time Figure 3D 


In, 




60 




M 


Luminance Fall Time 


i) v 




50 






Chrome Rite and Fall Time* Figure30 










n» 


1..' >A Mile Time) 


irCfjA 




60 






(6A Fall Timel 


l|CuA 




hi: 


- 




loB Riw TimeJ 


I.CoB 




fiO 


_ 




l£8 Fall Time! 


TrCoB 




60 






Field Sync, (FSI F.jure3A 


<WFS 




2,03 




mt 


iPi.lse '.'. (MM 












Row Present! RP) Frgur*3B 












(Pulie Widthl 


<WRP 




ona 




ut 


LDslav From HSI 


ihshp 




oga 




Ht 


Hofi/ontji Sync (HSl Figure 3B 


'WHS 




49 




m 
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FIGURE 2 VIDEO AND CHROMINANCE RELATIONSHIPS OUTPUT WAVEFORM 



Sync 
Bl.nl. 



:\ ' I 






4J — L 



End Of 

Hi>h/£mt»l kia * C£S 



VHI 

VR AG • A'G CSS 

V But*. 

VLO 



TJ 



AG • 
CSS 



lEJljTll II . 

for A/G • CSS ■ GMfli 



VHI 
Vfl 

VLO A CM 



Acttvt VldM 
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piiiia Bun 



I I r "«" 
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M>LjNrnTj| rVjugp 
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FIGURE 3 TIMING DIAGRAMS 



A PJahftSync 



LetdinQ f 10» ot 
V»rt. Blartkmg 



l**.HirM3 1 rSU» Df 



n-^l 



/ 



B How Fr»UI 




C ChrOiTUt Ph*** t5»t*v 




D 


Vtdta «.»», % i-jji 1 


irm 






L«unl - .' 






l -vtl • 1 


/ 


Lm«H m% 


^^^ Lsval • 1 


*. ¥ ^ 






L«*nl • 1 


A 




^e ifC$ -* 
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VDG SIGNAL DESCRIPTION 



Address Output Line* (DAO DA12) - Thirteen address 
used by the VDG tn scan the display memory 
The starting address of the display memory n located at 
■ turner of the display screen. A* the telt* 
vision sweeps from the left to right and top to bottom, 
the VDG increments the RAM display address These lines 
AfC ML compotiblt and may be forced into a high 
impedance *Mt# whenever the MS pm goes low 

Data Input* IDDQ-DD7I — Eight TTL compat 
fO input data Iftim RAM to lie proi 

1M.' VDG Thp ddlj is «r'tt'*preted d"f1 Erni . J ■ r r r : - = 1 ■ ; , 
lufninjnce Y "P*n 28! and color outputs >;A and OB lP-n 
11 and Pin 10| 

Pdw*r Input* - Vcc F enuire* + 5 volts VsS Mtquites 

■'tvanceand cur 
rent rwquircniWfiU of t>w VDG are specified in the 

HCS 

Video Output* tcA, OB, V, CHBl - These four analog 
„risfer luminance and color informa 
NTSC rok>« hilevii'ion tece-s 
via trie MC1377 RF modulator or directly into s 
n video inputs 

LUMINANCE lYl This »i* level anak>g Qutpul cr>n 
taint composiU' vv^c . bfankmg and lour levels of video 

. 

£A - This three JeveJ analog output •* used in comb"*j 
.jud V output! to specif v one of eight 

OR - Thii four level analog output isuv- 

'I e+ght 
colors Additionally, one analog level is. used to specify 
the time o< the coh.. 

CHROMA BIAS *CH8l This ptn nlri analog output 
and proyides a DC reference corresponding to itn 
■ I value of yA amJ oB CHB is used to gufan 
Kking and mmmn/. 
between lh* pattt 



and 55 percent since it controls the width of alternate 
dots on the television srrcfn The MCI. 37? RF modutalni 
- lied lo supply the 3.579645 MH/ clock and has 
provision* for a duty cycle adjustment, 

Syncluonishng Outputs (FS. Hi, RP* Three TTL 
com pal iIj I v outputi pfosj da circuiti, exterior to the Vf>G. 
with fimirtg references to the following rmernal VDG 
states 

MELD SYNC iFSl The high toll),', 
the FS output coincides with the end of active display 
area During Tins lime internal an MP{J may have rota' 
access to the display RAM without causing ufl 
(Ticket on the screen The Low to Hjgh transition of FS 
coincides with Ihe trailing edge of the verpral synchro 
nuke 

HORIZONTAL SYNC [HS\ The HS pulse is in 
coincidents Wit) .,-nlaf tynchroni/avh'...' 

• 1 to the television the VDG Thp 

high to low transrbon of ihe HS output corncruW with 

dw lead ■ '■! ..'■■■ 

pulse 

ROW PRESET iRPi ii drtireJl, an e*t^ 
jirier generaiof ROM may lie used wi(h the VDG 
Hgvvtwef, an enternaf four bit cQonlef must tvr arlded 
to supply row selection The counter is cfodted by The 

■ 

Mode Control Lines I Input I IA/G, A/S. INT,EXT H 
GMO, GM1 F GM2. CSS. INVJ - Eight H 
inputs mb used to curttrul The oj i le of the 

VDG a s mi t<l CSS md INV mav ' 

by charactei hflfiis the CSS pin is used to select 
between two pQfSJbta alphanumeric colors, whe- ■ 
is in the alphanumeric mixta and tietween tw* rolor sets 
mtgrai hies 6 and fu" 
r*b(s ! irlustraiei iht rafious modi 
■ 



Synchronic mq Inputs (MS CLKI 

Three-State Control - iMSI is a TTL compatible input 
. DG aildr&ss lines in I 
Etase rh*i may bi aw othe* devices 

an MPUi to i «emoiv l RAM I 

Clock ICLK1 - The VDG dock input (CLKl i 
3 579545 WHj (standa . tai freqiueinn 

wave The duty cycle of (hoj clock musl be tsivyeen 45 



DISPLAY MODES 

ih- VDG 11 capable ol genarahng \J dutincl m&uiay 
mpcfe$ Irefi" 10 tdhln li The color set wleciion and 
i'i, h -r' pint .vim allow variations on c*-rTain rnpdes Ttje 
VDG wrll display two alphanumeric modes with two com 

rphtc modt'j ot display Qi 
graphic modes. A datailefj description of the various 
modes at operation follow;, A summary pi major modes 
can I* found in Table 2, 
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ALPHANUMERIC DISPLAY MODES All alpha 
numeric modes occupy an 8 n 1? dot character matnx 
box duel there are 32 k 16 character boxes per TV frame. 
Each horizontal dot idol-clock) correspond! to one-half 
the period duration of the 3,58 MHz dock and each 
vertical dot is onn> scan hue Out- at two colors for the 
lighted dtis may bi selected by The color set select pin 
An infernal ROM will p&ntrats 64 ASCII display charac 
fers hi a standard & * 7 box Srx bill of thi? eight-bit data 
word arc used for the ASCII character generator and the 
two bits not used can be used To implement inverse 
color switching on a charnciei by character basis 
A 512 word display memory is required ior Ibis class 
i)1 display 

The ALPHA SEMI Graphics 4 mode translates hits tt?ro 
through three into a 4 x 6 dot element in the standard fl « 
1? dot Ixjx. Three data bits may tie used in seleci one ol 
eight colors tot the entire character box. The extra bit is 
available to implement mode switching on the fly A 512 
word display memory is required. A density of 64 x 32 
elements is available <n the display HM Thfl element area 
is four riot clocks wide by six lines high. 

The ALPHA SEMIGraphic 6 mooV maps sin A x 4 dot 
elements mlo the standard 8x12 dot alphanumeric box. 
a screen density of 64 x 48 elements is available. Six bits 
are used to generate this map and two data hits may be 
used to select one of tour colors in the display box 7h«! 
element area is four dot-clocks wide by four lines high. 

FULL GRAPHIC MODE - There are eight full graphs 
modes available fiom the VDG. These modes require IK 
to 6K bytes of memory. The eight full-graphic modes 
include an outside color border in one of two colors 
depending upon the color set select pin (C$51. The CSS 
pin selects one of two sets of four rotors in the four color 
graphic modes. 



The 64 x 64 Color Graphics Mode - The 64 x 64 color 
graphics mode generates a display matrix of 64 elements 
wide by 64 plements high. Each element may be one 
of four colors. A IK x 8 display memory is required. 
Each pictel equals four dot -clocks by three scan lines. 



The 128 x 64 Graphics Mode The 128 x 64 graphics 
rnOdfl yenerales a matrix 128 elements wide by 84 
elements hjgh. Each element may be edhei OH or OFF. 
However, the entirr display may be one of two colors, 
selected by using the color set select pin. A ?K x 8 tfisptiv 
memory is required. Each pictel equals two dot clocks by 
three scan lines. 

The 128 n 64 Color Graphics Mode The 1 28 k 64 

color graphics mode generates a display matrix 128 

Wide by 64 tJenwntJ high. Each e r em,>nt may be 

one of luui colors A 2K x 8 display memory is required. 

Each pictel equals two dol clocks by three scan lines. 

Th<? 128 x 96 Graphics Mode Thir 128 M 96 graphics 
mode generates a display matrix 128 elements wide by 96 
elements high Each element may bv either ON or OFF 
However, Ihe em w d splay m*y bo i"^" ol two colon 
selected by using the color select pin, A 2K x & display 
memory 'S required, Each pictel equals two dot-clocks 
by two scon tints. 

The 128 x 96 Color Graphics Mode Tha 1 28 x 96 
color graphics mode generates a rjisptsy 128 elements 
wide by 96 elements high. Each element may be one of 
four colors. A 3K x 8 display memory is required Fach 
ptctel equals two dot clocks by two scan lines 

The 128 x 192 Graphics Mode The 12B x 192 

,■ ii ■ a mode generates a display matrix 1?R ■ 
wide by 192 elements high Each dement may be on her 
OH oi Of F , but thf ON ,m of two 

colors selected with color set N a 3K * & display 

mrmory ■ •» required Each pictel equals two dot-clock* by 
one scan hne 

The 128 x 192 Color Graphics Mode - The 128 K 192 
color graphics mode generates a display 128 tJemenfS 
wide by 192 elements high. Each element may bj 
four colors A 6K x 8 display mtftwy if req 
detailed description of the VOG modes is- given in Table 3 
Each pictel equals two dot-clocks by one scan I me. 

The 256 x 192 Graphics Mode rhe 266 M 19? 
graphics mode generates a display 256 elements wide by 
192 ilem*nt3 high Each element may be *■ I 
or OFF. but the ON eternenl may b« one of two colors 
selected with ibe color set select pin, A BK x B display 
memory is required. Each pictel equals one dot clock 
by one scan line. 
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TABLE 1 - TABLE OF MODE CONTROL LIMES IINPUTEJ 



S r, 


X/s 


fNT :EX 7 


irgv 


GM2 


r.M i 


GMO 


ALPHAiGRAPHIC MODE SELECT 














X 


X 


X 


Internal A iOh anurnerici 











1 


X 


X 


X 


iMWMl Alnh»nijn>eM£* Inverter) 








1 





X 


X 


X 


Fur--' hi AlpfttnuNMnei 


a 


p 


1 


1 


X 


X 


X 


External Alphanumeric! Inverted 


D 


1 


a 


X 


X 


X 


X 


SerruniaphHTi ■ 4 





1 


i 


X 


X 


X 


X 


Semigranhicv ■ 6 




* 


X 


X 


o 








64 * 64 Color Graph phi 




1 


X 


X 








1 


IJfliM Grafihpct 




X 


X 


X 


a 


1 


a 


12B . 64 CnlDr Graphic*, 




I 


X 


X 





1 


i 


128» "J6 (jraph.ri 




N 


X 


N 


i 


g 


D 


1 28 N 96 Color Graphprs 




* 


X 


X 


! 


n 


1 


128 • T92 GTdphin 




• 


X 


X 


1 


i 


11 


128- i92Cmor Qnetua 




I 


X 


X 


1 


i 


1 


JS6 k ISIGraph.t, 



TABLE 2 SUMMARY Of MAJOR MODES 

MAJOR MODE ONE 
TABLE OF ALPHA MINOR MOOES 



M - 


Mfcmwi 




Dufrin ' 


Alph«num«nr -1 1 ri 1 6r nil 1 1 


5 1 3 « a 


3 




MpttmitmuH 11 • 


si?* a 


2 


Bowl T J Fien^m 

Bun \. l ... Eirnnnnf 


■ 


51?. B 


B 


AtiHuS 


5t? i H 


4 



MAJOR MODE TWO 
TABLE OF MINOR GRAPHICS MODES 



Title 


Memory 


Coton 


Cnmrwnli 


64 m 64 Color Graph pc 


IK a S 


1 


1 4 . 64 

E inmartl? 


12B i64Gr«iti,ci' 
I2B» 64 Color GrMin 


IKmB 

7K . B 


2 

4 


Main. 128 
elements vvprle Ijv 
64 element* high 


12S4 96Grj. 

1 28 * 96 Color Graph K 


1 5K . B 

;• . B 


2 

4 


Mavr.a 12B 

piemen! t rtirie \Ji 
96 piemen M nigh 


128 ■ 192GFaph.tr 
1ZB» 1 92 Color G.eph.t 


3K >B 
6K ■ B 


2 

4 


Mutt. > 12B 
elemrrrifi vtppJ* Ire 
1 92 element! high 


25£> 192 GpaDh.t.' 


6H .8 


? 


Matri. 356 

Etemfinti wprie Irv 
1 'J j' itwABPtJ hiojl 



'GripR-tt-trTiodi lurnian or off »*rh vlemttnt, T I 1 -* color mav bean* ol two. 
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Appendix 4 
MC6821 data sheet 

Supplied courtesy of Motorola Semiconductors. 

The Information here has been carefully checked and Is 
believed to be entirely reliable. However, no 
responsibility Is assumed for Inaccuracies. Motorola 
reserves the right to make changes to any products 
herein to Improve reliability, function or design. 
Motorola does not assume any liability arising out of 
the application or use of any product or circuit 
described herein. No licence Is conveyed under patent 
rights In any form. When this document contains 
Information on a new product, specifications herein are 
subject to change without notice. 
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(M) MOTOROLA 

SEMICONDUCTORS 

Colvilles Road, Kelvin Estate- East Kilbridge Glasgow SCOTLAND 



PERIPHERAL INTERFACE ADAPTED I PI A) 

The MC68?1 Pwipheiai Interface Adapts pruvittes rhe universal 
\i interfacing perfpfn , orrt tc the M6800 ".< 

wesson This device >b r^pable ot interlacing in© MPU to 
\]l£ through two B-hit bidireciiana 
four control fir ■ | . ■ - t \q most 

I ■ i ices 

the PlA is proypamrited bv the MPU 

tfunngsystarn initialization Each ol the p* nes c*n btr pf 0- 

".1 to act at* w (our con 

several control 
modes ' jfation of 

the interlace 

• eVBir Bidirectional Data Bus 
MPl) 

• .-•■■ lace u* PBf»pnfif3is 

• Two Prtkjjrammable Control Rag 

• ■ 

Usafalfc an Per»phera- Contra* Gulp I 

• .■ and Output Peripheral 
Qpersti 

■ 

• ■ apafjihly 

• CMOS D"- 

• Two T T I Dtivc Cap :: 
• 

• Stalic Operation 



MAXIMUM RATINGS 



ChaiactrT.'.t.. ■-■ 
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jo i, . m 








if . . ■;, 





THERMAL CHARACTERISTICS 




- ■ ■ 
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(1.0 MHz] 
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DEPLETION LOAD) 

PERIPHERAL IMTERf ACE 
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S SUFFIX 
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PIM ASSIGNMENT 
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POWER CONSIDERATIONS 

The average chip junction temperature. Tj. in *C can be obtained from 
1j-T A *IPp«fljAl 

Where 

TA»Ambieni Ternperatu'- 

)jai» Package Thermal Resistance, Junction- ID-Amoiem. *CW 
Ptl-PlNT ' p POflT 

Pint • ice > Vcc. vvaus - cnip internal power 
ppOBT^Poii Power Dissipation, Watts - User DetetmtrtetJ 
for most applications PpORT"*P|NT aid can be negtectetJ PpORT "wv become snjnibcant .f the device is conhgured to 

r ■ ■ ;■ :..■■.■■ .[ v-i I i P .!.:!', 

.ipp'omrnate relationship between Pq and T j hi F'pqrt n rwigreciecil is 

pd • t'Q ia 

Solving equations 1 and 7 lor K gives 

.•i1a*273"CI + »ja«PD 2 
Where K is .i ;• reticular part K can be determined trom equation 3 bv measuring Pq tat equilibrium} 

for a known Ta . .I'tie of It the values of Pp and Tj can be obtained by solving equations I T i and t2i iterativelv for any 

value of T a 



DC ELECTRICAL CHARACTERISTICS V CC -50V(K t lo I H unless Olheiwiie noted) 

Mto [ Typ | Man j Unit 



Charactehvric 



I 

BUS CONTROL INPUTS IR'vV. Enable, RESET, RSO RSI. CSO, CSV CS2I 



"(•■. I 1 V '.Ml- 


•M, 


vss+a .'■ 


- 


Y« 


V 


■ 1 V . ,'. '. M.j- 


«<L 


Ki - u I 




VSS'fJB 


v 


Input leakage Cunenl IV 1n - to 5 25 VI 


1- 




1 


2S 


»A 


Capacitance tV ln » Ta«35'C. •- I MH?I 


Ct 






7f> 


.' 



INTERRUPT OUTPUTS IIRQA, IROB) 



Output Lew Voltage "uiact- 3 : " ,A1 


VIM 






v ss .o* 


V 


Three- Slate Oulput Leakage Cunern 


■0? 




to 


"tb ' 


.a 


Capacitance iv„, . 0, T A - 26 "C, t » 1 MHil 


c uor 
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DATA BUS! QO 07 1 



Input Hign Voltage 


VlH 


V SS .J0 




U CC 


V 


Input Lew Vutlage 


VlL 


vss - o 3 




/gjj .I1H 


V 


Fii-w ■■:,;. : .■ . . ,.,i... .:'•■■■ . ,, i ■ ■ . J '.' 


•|Z 




20 


10 


e* 


■''.■:..■ •■'!• . • •■+- i, , . ..- n- 


If OH 


vss *■' * 






V 


. i ■> ■• '■ : 'ij I-. ' , . : • n A 


VOL 






v ss -0< 


V 


.:jijjiiui-. . . ,. . r A ."-■ ■ < i '. uhi 


C,„ 








of 



PERIPHERAL BUS IPA0-PA7, PBBPB7. CA1, CA2, CBt. CB2I 



Input Leakage i R'VV\ RESET. RSO. RSI CSO CSt £51. CAt. 
IV m =0to5 26Vl CB1 EneWe 






10 


u 


»A 


Tnroe Stan Input Leakage Current IV,, = 04 to? J VI POO-PBi -.' 


'IZ 




20 


10 


»A 


InpulH^nCunentlViH-jaVl PAUPA7. CA? 


l|H 


300 


-400 




Dari.r. 9 ion Drive Current IV 1 PBOPB7. CB2 


IOH 


- TO 




-to 


mA 


Inpul Low Current (V|i-0* VI PA0-PA7 CA2 


'IL 




-tj 


-24 


rtiA 


Output High Voltage 
ll L oad- -SOOfAl PAO-PA7.PeOPB7CAJ.CB? 
"Lo^j" " lOpAl PAO PA7. CA2 


VOH 


v ss * 2 a 
vcc - 1 o 






V 


Oulput L«w Voltage tlLoerJ = 3 ^ "^ 


Vol 






v ss ,o* 


V 


Capacitance IV,,,- 0, Ta-26"C. f- 1 OMHjl 


C,n 






10 
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POWER REQUIREMENTS 

I internal Powai Davipation IMeasurad at T a 



Pint | 



660 j «nW~~j 
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BUS TIMING CHARACTERISTICS 



Idem 
Numbef 


ChsractvnstK 


Syrtiol 


m«82i 


MC68A2I 


MC68B?1 


UniT 


Mm 


'.<.!. 


Mm 


Ma. 


Min 


M.t. 




. ■ Inw 


*C¥C 


1 


10 


OBJ 


H! 


• 


ID 


»■' 


3 


■ A :'■ ■ i a 


PW tl 


1) 






. 1 




' ■ 


3 


PuBt W.at's t M.)[l. 


l".\ M 


49 




■Ml 




220 






I 


1 


't. '1 




a 




A 






rti 


9 


■ Hold Tunc 


'Ah 






: 










13 


AU'K' .■",; " '< :'• ■ - ! 


las 


BC 




60 




1 






11 


■ ■ •■ Sttlup lunet finfoie f 




ao 




■■ 




m 




"V 


15 


CtVO S>!KTl Hoid 'l™t? 


'Cti 


K 








in 




1^ 


IS 


Rtwl Djv* Hold T " ri '- 


'DHH 


:■( 


-.. ■■ 


za 




20 


' 






WntiJ [>j*Ti Hlild TirTM.' 
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'■.;. 
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TO 
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Dutpui rj.h-.i 0" i 


HMjh 
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180 
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FIGURE 1 BUSTJMIWG 
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PERIPHERAL TIMING CHARACTERISTICS iv C c» Uv t5%. V 


S5=0V. 


T A =T 


1_ to T 


H unless olhe 


wise specifier: 








Symbol 


MC6821 


MC68A21 


MC68B21 


Unit 


Reference 

Fig No 




Min 


Max 


Min 


Max 


Min 


Max 


O^i^i Setup Tune 


'PDS 


20Q 




135 


- 


100 


- 


ns 


6 


Daia Hold Ti.-^e 


1PDH 


C 


- 





- 





- 


ns 


6 


Delay Time. Enable Negauve Transition to CA2 Negative Transition 


'CA2 


- 


1 


- 


670 


- 


500 


K> 


3, 7, S 


Delay Time. Enable Negative Transition to CA2 Posmve Transition 


T nSI 




1 


- 


670 


- 


0.500 


es 


3, 7 


RiSt' and Fall Times for CA1 and CA2 Inpul Signals 


I ( . 'I 




1 


- 


1 




1 


es 


8 


Delay Time Iroin CAI Active TransiliOn to CA2 Positive Transition 


<FtS2 


- 


20 


- 


1 35 


- 


1 


*s 


3.8 


Detay Ttmrv. Enable Negauve Transition to Dai a Valid 


tpQW 


- 


t 




670 




05 


^ 


3. 9. 10 


Delay Time, tnable Negative Transition to CMOS Daia Valid 
PA0-PA7. CA2 


'CMOS 


- 


20 




1 35 




i 


flS 


4. S 


Delay Time. Enable Posnive Ttensition to CB2 Negative Transition 


'C82 




1 




670 




05 


es 


3. 11. 12 


Delay Timo. Daia Valid 10 CB2 Negative Transition 


'DC 


20 




20 


- 


20 


- 


ns 


3. 10 


Delay Time. Enable Posmve Transition to CB2 Positive Transition 


'RSI 


- 


1 




670 


- 


05 


(<S 


3. 11 


Conirol Ouieui Pulse Width. CA2:CB2 


PWct 


5C0 


- 


375 


- 


250 


- 


ns 


3. H 


Rise and Fall Time for Cfil and CB2 Input Signals 


t r tr 




1 




t 




1 


p 


12 


Delay Time. CB1 Active Transition to CB2 Posihve Transition 


'RS2 




20 




1 35 




1 


?z 


3. 12 


imettupt Ftetease Time. IRQA and IHQB 


'IB 


- 


1 60 




1 to 


- 


85 


fi 


5. 14 


li.i"ii'i[.i H*\l.<--n ~ 1in.~ 


'RS3 


- 


1 


- 


1 




1 


»s 


5. 13 


Interrupt Input Pulse Time 


PW| 


SCO 


- 


500 


- 


500 


- 


ns 


13 


BESET Low Time' 


IRL 


1 1) 


- 


066 




05 




r»s 


10 



* Trie HESET iint mu^L t>e h.ig.ti a nrunimijrn ol \ pi*, twkire addrisssui^ the Pi A 



FIGURE 1 - BUS TIMING TEST LOADS 



Tes[ Pomi t>— , _ 



-M- 



MMD6150 
Or Lguiv. 



MMD7000 
Or Eo,uiv 



FIGURE 3 - TTL EQUIVALENT 
TEST LOAD 

1PA0-PA7, PB0-PB7. CA2.CBJt 

,50V 



T*St Pomi O 




C=30 pF. B = 12 k 



FIGURE 4 - CMOS EQUIVALENT 
TEST LOAD 



FIGURE S - NMOS EQUIVALENT 
TEST LOAD 



IPA0-PA7, CA2I 



IIROOnlyl 

5.0 V 



TeST Point O — 
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FIGURE 6 - PERIPHERAL DATA SETUP AND HOLD TIMES 
rHaod Model 



FIGURE ! - CA2 DELAY TIME 
IFtMd Mod*. CRA 5 CRA3 I CW4 fli 



PAD l*A / 



x '<= 



•4 H-[j:h f— 



7^ 



A^^^ 






~ \ — "~v 

i -^i iinnm 



FIGURE B CA2 DELAY TIME 
IRo.d Mode: CRA 5 1. CRA 3 CRA 4 Oi 



FIGURE 9 PERIPHERAL CMOS DATA DELAY TIMES 
iWnto Modo; CRA 5 CRA 3 I. CRA* 01 
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- — 



X 



/.: — 



~v_ r 



^v 



■ 



zx' 
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FIGURE TO PERIPHERAL DATA AND CB2 DELAY TIMES 
iWrii* Mode; CRB 5 CRB 3 1. CRH-4 01 



FIGURE" CB2 DELAY TIME 
(Wrin, Modo. CRB 6 CRB 3 I, CRB 4 01 



\ / 

r oh tpi 

X 



nm _ ippyv 






C.B2 gO« IU« JjkJj H.-VM rtl Irtd 

.- Qrf I.- '1*1*1 it 



\ 



/-^s^r 



S r' 1 '""--] ^ 



■ ■ . > ■ . . ■ . 



FIGURE 13 - CB2 DELAV TIME 
(Writ* Mods, CRB 5 l. CRB 3 CRB 4 0> 



/~V 



I~X 



-* : I . - 



■KW — 

V_ A 

*AW)flin *»*'■ .-.J> EMCBt« TCI) tjus.ntj 

irvl»tvuijiV pull* 



FIGURE 13 INTERRUPT PULSE WIDTH AND IRQ RESPONSE 



cai.j V" 1 "V 



j: IK B>n *<* »"T 



' mmy rn^asufemenis mv ittlwtoWAra loand from jIua ^tag* «! n8 wrfra flnd » h.-.r . ■ < (too* i 
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FIGURE U IRQ RELEASE TIME 



J- 






■ 



r 



FIGURE '5 - RESET LOW TIME 

- 



\ 



y 



*ft>e flfSET <<r>* rrmXt be ■• Vim " 



Noifi Tirt'ifig rrwaujremeii^ an? «i?*Bitmced to ana frarin a low voJtjigB at 8 voln ai-d d h<i)h viitiage ot 2 WJ*t*, unless eirwMv no-tod 



FIGURE 16 EXPANDED BLOCK DIAGRAM 
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P1A INTERFACE SIGNALS FOR MPU 



The PI A interfaces to the MbUDO bus vwthan ft-bii I 
uonat artTd bus, three chip select Hnes. two r^gute* setecf 

hno To ensurp proper operanor 
MCB80Q. MC6B02. oi 

r d used as an active pan tv " ■ 



bidirectional Dai a \OQ-Q7\ 

■ M 

■ 
■ 

" '■ ■ ■ . ■ 

■ ■ . 

Enable IE! I , liming 

sgnal that 15 supplied Id the P5A Tuning dl ril 

md trailing edges of the I 

Read Write (fl W:< ted by ihe 

MPU to control The direction ot data transfers 00 The date 
pus A toASia!* 

butters and data it transferred Irom ihe MPU to the PI A on 
thu t stgna> if the dev elected Atug 

read ww ffl hne sets up ■ fa* o< data 10 the 

he J 'gperatl 

■ ; die present 



ft^H 



ow RESET line s used lo-fi 

1? can be 

used as a povrai 1 master »esei during 

I '■ M 

Chip Selects ICSO. CSV and C$21 n 
Signals ar> 
high and CS? n . 

'a enable 
and read' write signals The chip select lines must be stable 



to» The puratcon of me E pu 

. ■ . . 

Register Selects IRSO anfl RSll 

■ ■ 
Pi A Tnese two imes dre use T 
Conirof Registers to sf 
■ 

'•ouid be siat ■ 

. ■ 

Interrupt Request I I RQA a nd i RQBl 

ler'upi R- . ■ 

These i>nes are 

joiner ma 
nation 
Each li 11 test Una has tvw 

tuts thai can can ■ 
flag bji ts associated . 

tone AfcSOj ire provided in the P«A 

wtucb may be used 1 * 'lrerrupt hom a 

• •'. al device 
ServH ■ ipl by "he MPU may be ace 

bv a so tt .■ ,j t , on a prioritized basis . » I 

reads and 1S8U ' 
lerrupl hag bits thai are SCI 

lenupl flags are cleared tierced' as a result of an 
MPu Read Periphe«ai Data Qperahp" of the corresponding 

■ ■ ■ ■ 

not be enabled ' the PI A is deselected du^ng ai> 

F pulse " jsed to condition the inter*...; 

lines ICA1. CA2 h Cfll. CB2i > -' used as 

■ 

active edgi ■* edge ot the 1 ■ agnatic 

nse network. It live rnte?rupl flag has 

been enabled and il bobc circuit has been properiv 

conditio' - rupt (fag will be set on the next active 

' the interrupt input pin 



PIA PERIPHERAL INTERFACE LINES 



The PIA provides two B-bit biduechonai data r 
vrtacing to ; 

■ 

Section A Peripheral Data [PA0-PA7I Each pi the 

■ ■ . . , ■ 1 1 

output This ns accomphshed bv setting b 

-i Data Duedron Regw those lines vwhveft 

ate to be outputs. A "0" m a bit of the Data DirecTion 
Register causes [he corresponding peripheiai data line to act 
as an input During an MRU Read Peripheral Data Operoudn. 
[he data on peripheral lines programmed to act as inputs ap 
pfcats uVectfv on the corresponding MPU Data Bus lines In 
the mput mode, the internal puilup restfitoj on ihese lines 
represents a maxaTrnj*' . >oad5 

The data in Output Register A will appear 
[hat are programmed io be outputs A logical T" written m 
•■• ■ cause a '" high'' ei-' tn B cc«TDSpondmfl data 



line wtnle a ' 0" resu'ls in a -ow " Datarn Dutpui Register A 
may be read bv a ' Penphera- Data A" opera lion 

''■ed as outputs 
Thts data will be read property if the voltage on the 

pehpheri 

output and less l ha^ OB volt for a logic sdtng 

iuCh that the voltage on mese lines does not 
voltage causes ihe 
011 a Read operatirjn to differ from that contained >n the 
recpectJue tut of Outpui Register A 



Sectton 8 Peripheral Data tPB0-PB71 The peripheral 
data lines in ihe B Section of the PIA can oe prpgrammed to 
act as either input? of 

■ ■■ ■ ■ .- ■ ■ ■ . .■■■■■ - 

pedance state wnen ihe peripheral data nne is used 
■ ■ ■ ! kta or the peni ' 
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PBG-PB7 will be read properly from those linos programmed 

as Outputs BVQn it |hs voltages fffl bfcldW 2 voltS tor J 

I |j ■ .je . ,'? OS V for a "tow" M outputs, iheso irnes 
art; compatible with standard T T L and tnjy also be used as a 
source a I up W 1 rTiillKimtjrjre .it 1 Bvolis in : ■ 
Btrjioi switch 

Interrupt Input ICA1 and CB1 p Penpherai i^tuJt imos 
CAtandCBlar- ; . ines thai set ihe mtetrupt fags 

□I the control registers The active transition to* ihose 

:■ i ra also progr.j' r wo control registers 

Peripheral Control ICA2> The peripheral c a " 

Me programmed in art a* an interrupt input Or as a 



peripheral control Output As an output . this (me ■& compaii 
Die with standard TTL, asan input thd 9 resistor 

on thus bne re&ftti mdard Hi loads The function 

at this SKjnji hrte >s programmed with Control Register A 

Periprw*} Control (CB2) Peripheral ConiTOl line CB2 
may also b*r programmed to act as an interrupt input or 
perrpheral control output As an input, this line has hrgh m 
put impedance and «s 

output it «5 compatible with standard TTL and mat 
used as a source ot up to 1 miHiampere at 1 b volts * 
drive the base of a transistor switch Tht5 Ime is programmed 
< Register B 



INTERNAL CONTROLS 



INITIALIZATION 



A BESF " . -ill PIA regisv 

will sat PAD- PA"/. PB0-PB7. CA2 and CB2 as inputs, and all 

- ,3 the PtA must be configured J 
restart program which follows Hie reset 

■ ocabons wtthai the PIA accession* to ihe 
MPU data bus two PHrijihwal Registers, |w 
Registers, and two Control Regulars Selection gl these 
locations is controlled by the ftSQ and RSI inputs together 
- 2 m the Control Register, as shown m Table 1 
Details ot possible configurations til the Data Direction 
and Control Ri i -News 





lABlt T 


INTERNAL ADDRESSING 


RSt 


■ 


■ 


Local 


- H fl. 'J 




D 





1 


K 


; .*A 










f 


l RtqifUi A 


n 


i 


H 


* 


nii-uiUi" A 


i 




X 


1 


iV-ijLhv .1 Hoyrtlti & 


i 






■ i 


■ 


1 


X 


I H«q)*tli H 



PORT A S HARDWARE CHARACTERISTICS 
AsshawnmF -. M ..I Mas a pan o' ' 

liffer Jesigned 

MOS iiHjki; to normal 30% to 70"^ levels, andirxor 
poraies an internal pullup device that remains connected 
Because ot this, the A side requires 
more drive cut=* pul mode than Port B 

fast, the B side uses a normal three state NMOS butter 
b- not pijliup to CMOS tavets without extern-ail 
frrvt OHtnj loads such as Darl 
ingtons without problem When thf i iiof reset. 

.-.ith tnjllup resistors, whereas 
the B s«d+ BlSOt will tloat high or : ■-■ 

me load conna;ied to if 



Notic* ■ 
operation when tn tha output mode When reading Porl A. 
r':e 9 side read comes from an 
output tatch anead of the actual pm 

CONTROL REGISTERS (CRA and CRBl 

r^MPU 
to control the 0| I ['er*pheral Control lines 

CA1.CA2.CB1. and CB2 In addition they aHow the MPU to 

a interrupt lines and morn tor the status ot ihe inter 
lets may be writ 
ton or read bv the MPU wnen the proper chip select and 
regisier select signals a*e applied Bits 6 m 

ye read onlv and an? modihed bvexiemal interrupts 
occumng on control hnesCAl. i)A2. CB1. or CS2 The lor 
ma.i of the control wO'ds rs shown in figure 18 

DATA DIRECTION ACCESS CONTROL BIT (CRA-2 and 
CRB 21 

RA and CRB" 
mmes sMciion ol either a Penphexel Ouu^ul Register or the 
cotfespond'ruj Data DffecTiori E Reytsfet .-. ' 

agnate are applied to RSO and RSI 
bit 2 aliows access of the Peripheral I menace Reyr ■■"■ 
a "0" causes the DaTa Directiofi Register to be addressed 

Interrupt Flags ICRA 6, CRA-7. CRB-6. and CRB7I 

interrupt t^ag bits are set I fttions of 

signals on the tour inierrupt and Peripheral Control lines 
when those lines are programmed to be inpuis These bits 
cannot be set directly hom the MPD Data Bus anil 
indirect^ Pv a Read Peripheral Da(a Or>ef i f ^ - u 

pr opr>ate section 

Control of CA2 and CB2 Peripheral Control Lines (CRA 3, 
CRA 4, CRA-5 r CRB 3. CRB 4. and CRB 51 Bds 3. 4 and 
&ot ttiLMwocontrolrec^stersarBijisedlPConironheCA2and 

CB2 Peripheral Coritrol lines These bits determine if the con 
trol lines will be an mierrupt input or an output control 
signal libit CRA-5ICRB &l is low, CA2 (C&2J «su- 
input line similar to CAT LCBD When CRA-b ICRB ^i is 
high CA2 ICB2I becomes an outpui signal that may be used 

When "• " i 
mode. CA2 and CB2 havt bfferent loading 

■ 
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Control of CA1 and CB1 Interrupt Input Lines (CRA-0, 
CRB-1, CRA-1, and CRBD - The iwo lowest order bits of 
(he control registers are used 10 control [he interrupt input 
lines CA1 and. CB1 Bits CRA-0 and. CRBO are used 10 



enable the MPU interrupt signals <RQA arid iTtQB . respec- 
Wvety. Bits CRA-1 and CRB-1 determine ihe active transition 
of tl^ interrupt input signal CAT arid CB1 



FIGURE 17 - PORT A AND PORT G EQUIVALENT CIRCUITS 

Port B 



0~ATA ■ 



Direction 
H-OutOut Pm> 
<0- input Pin I 



Bus j. 



iTZ. f™ — *\ /fl^i i 1 Daid Onect'.o^. -K ^ 




Internal PIA Bus 



ll-lnpui Pmh 
,^— - 10-OulpuL Pin) 

1 A- Head ot B 
^H / fJ^r^ When 
m OuLpui 
Mode 



Vet 




Read oi R 

Data v^tien 

in inpul Mode 



ORDERING INFORMATION 



MC68A21CP 



Motorola Inieyrinerj i 

M6BGG Family - 

BUnks^ 1 MH; 
4^ 1 & MH; 
B= 2 MHj 
Devite Dr^Siynalifn - 

in M6B00 Family 

lynioeMiurLj Range - 
Blank =0-"— * 70 J C 

c= jo - - e&-c 

?£<.:* ay* 

P = flftSIH-. 

S = C&dip 
L - Cerar-nc 



BETTER PROGRAM 

Baiter proa/ani process^ n& available on an ivp** iisied Add 
sullix titers io parr, numbe* 



Level 1 add ' S" 



Lfvei 2,idd D" 



Ltvt* 3*il<l OS ' 



Ltvei 1 "S"= 10 Temp Cycles - i - 25 :n 15Q- 

Level 2 "D" - 168 Hou' Bum m £l 125 J C 
Level J "DS" -r Omu-malion ol lfiv«l 1 jnd 2 



Speed 


Device 


Tettiperaiure Range 


1 MHZ 

1 5MH; 

2 MH; 


fJIC6621t-.L.S ' 


lu <'} L 


MC682ICP.CL.CS 


- 40 lu » 8b C 


MC6BA2IP.L.S 
MC68*!ICC. CL.CS 


o iu - 70 c 


MC6SB21P.L.S 


o M - ;o c 
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Determine Active CA1 ICB1) Transition for Setting 
Interrupt Flag PRQAlBll - ibrt 7} 

b1 =0 IflQAtBM sei by high -in-low Iransmon onCAl 

(C81) 
hi = l iRQAiBH set by low-io-higii nansnion on CA1 

(CBD 



|RQA{BI 1 Interrupt Flag [bit 71 
Goes hi-gri on acuve transmon of CA1 HCB1 i . Automa- 
tically cleared by MPU Read ol Output Register AtRi 
May a'so be cleared by hardware Reset. 



FIGURE IB - CONTROL WORD FORMAT 



CA1 ICB1J Interrupt Request Enable/ Disable 

bQ = Disables iRQAtBi MRU Inteffupt by CAT 

iCBIh acnve iransmon 
b0= 1 Enable IRQA(B) MPU inierrupi bv CA1 (C8U 

acnv& lransmoi. 
1 ifiQAtBi will occiji on nexi (MPU generatedl positive 
transition of bO if CA1 iCBtl acnue iranS.HiQn oc- 
curred while interrupt was disabled 



Control Register 



bl 


b6 


b5 I 64 | t>3 


b2 I bl 1 bO 


IBOAIB1I 
Flag 


IHQAIBI2 
Flag 


CM tCB2> 
Control 


Access 


CA1 (CB1I 
Comrol 



zc 



IRQA(B)2 Interrupt Flag (bit ft 

When CA2 lCB2r is an mpui. IROA(B) goes hign on ac- 

live transition CA2 (CE2): Automatically cleared by 

MPU Read ol Output Reg^ter AlBi. May also be 

cleared by hardware Resei 

CA2 ICB2) Established as Outpul (&£ = ll. iRQAtBt 

2^=0. ixn affected by CA2 ICB21 tiansmons. 



Determines Whether Data Direction Register Or Output 
Register is Addressed 

b2 = Oala Direcnon Register seleded 
b2= 1. Outpu! Register selected. 



CA2 tCB2> Established as Output by b& — 1 

(Note iha< operation ol CA2 and CB2 ouiput 
bb b4 b3 J unci ions ate not identical 
— ^ CA2 

b3=^0 Read Strobe with CA1 Restore 

CA2 goes low on hrsi high-to-low 
E irans^lKjn loiiowmg an MPU read 
ol Output Ftegisier A r returned high 
by nexi active CA1 iransmon. as 
specked by bit l. 

b3 = 1 Read Strobe with £ Restore 

CA2 goes low On first high-to-low 
E iransmon following an MRU read 
of Output Register A, relumed high 
by next high -to low £ Iransmon dur- 
ing a deselect. 
-*• CB2 

&3 = 0. Write Strobe with CB1 Restore 
CBI goes low on first tow io- high 
E. transiiion louowingi an MPU wrne 
into Outpu i Register 6, rgiurned 
high by the next active C61 transi- 
tion as speeded by bn l. CRBb7 
must lirsi be cleared by a read of 
data. 

b3=1: Write Strobe with E Restore 

CB2 goes low on first lowMo-high 
E transition following an MRU write 
into Outpuf Regisier B, returned 
high by 'he ne«t low- to- high E tran- 
sition following an E pulse which 
occurred while the pan was de- 
seiecied 
~+* Set/Res*tCA2|CB2) 

CA2 ICB2) goes low as MPU wriies 

b3 = into Control Regisier 

CA2 (CB21 goes high as MRU writes 

b3 = 1 into Control Register 



CA2 ICB21 Established as Input byb&=£ 



b^5 b4 b3 



U 



CA2 IC821 Interrupt Request Enable /Disable 

b3 = Disables IROAtAl MPU Interpol by 

CA2 ICB21 active iransmon ' 
r>3= 1 Enables IflQAtBl MPU Interrupt by 

CA2 tCB2l active iransmon. 
'iRQAtfi] will occur on next 1MPU generate 
ted) poitive iransmon of b3 il CA2 1CB21 
active Iransition occurred while interrupt 
was disabled. 
^Determines Active CA2 [CB£| Transition lor 
Setting Interrupt Flag IRGA(B12 - [Bit b€) 
n4=C>- IRQA'612 sei by high -to -low- uansi- 

tion on CA2 'C621 
b4* t: IRQA<Bi2 sei by low-io-high transi- 
har) on CA2 'CB2) 
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Appendix 5 
The Dragon 64 



The major design aim of the Dragon 64 was to ensure 
upward compatibility with the Dragon 32 and yet provide 
a machine with enhanced facilities. These extra 
facilities are: 

(1) An additional 32K of RAM. 

(2) An RS232 (serial) interface. 

(3) Auto-repeating keys. 

As the Dragon 64 is virtually identical to the Dragon 
32 in most other respects , we confine ourselves to 
describing these extra features and detailing the 
differences between the two machines. 

1. SWITCHING IN RAM 

The SAM chip, described in Appendix 2, can operate in 
two modes called map type and map type 1. This 
allows the chip to map addresses to either a 32K or to 
a 64K RAM address space and this facility means that 
compatibility between the Dragon 64 and the Dragon 32 
can be maintained. 

Unlike the Dragon 32, the 64 can operate in both map 
types provided by the SAM chip and yet still use 
Extended Color BASIC. On power up, the 64 is 
configured like a 32 . In other words, it is in map 
type which provides access to 32K of RAM, addressed 
from 0000 to 7FFF, 16K of BASIC ROM, addressed from 
8000 to BFFF, and 16K (minus 256 bytes for I/O devices, 
vectors, etc.) of expansion space addressed from COOO 
to FEFF. Switching in the extra RAM involves switching 
to map type 1 which, gives a 64K RAM address space (less 
256 bytes) from 0000 to FEFF. 

The extra 32K of RAM therefore 'overlays ' the BASIC 
ROM and expansion addresses which means that neither 
the Extended Color BASIC ROM nor the cartridge ROM can 
be accessed. It is therefore necessary to 'bootstrap' 
the machine by first copying a small program into RAM 
which selects a 'new' BASIC ROM and copies its contents 
into map type 1 . Naturally, the new BASIC ROM will 
reside in map type and therefore the bootstrap 
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operates by reading a byte (from the ROM) in map type 
0, switching to map type 1, writing the byte, switching 
back to map type to read the next ROM byte and so on. 

Because the new BASIC does not need to reside in the 
same address space as the 'old' BASIC, it can occupy 
the addresses COOO to FEFF. This relocation of the 
BASIC results in 48K of RAM being made available for 
system/user use. Naturally, if the BASIC interpreter 
is not required, e.g. when using the OS-9 operating 
system or machine code programs, the full 64K of RAM is 
available to the programmer. 

The bootstrap procedure is invoked by EXEC on its 
own if no other EXECs have been used. The Dragon 32 's 
default entry in the EXEC vector has been replaced by 
the entry point of the Dragon 64 ' s bootstrap routine . 
Alternatively, if an EXEC has been used, EXEC 48000 
calls the bootstrap entry routine directly. 

The 64K mode can be distinguished from the 32K mode 
by the fact that the cursor flashes blue rather than 
black. One point worth noting is that booting into the 
64K mode will not wipe out an existing BASIC program as 
it behaves like a CLEAR command. Subsequent resets 
after the initial 64K coldboot will perform a 64K 
warmboot so that the system remains in 64K mode and 
does not revert to 32K mode. 

Some extra 'housekeeping' bytes which are unused in 
the Dragon 32 are used to keep track of the boot state. 
FLAG64 (11A) indicates whether this is a warmboot or a 
coldboot. A warmboot (FLAG64 = $55) indicates that the 
new BASIC has already been copied into RAM in which 
case a further two bytes (11B-.11C) hold a 16-bit 
checksum that was calculated during the BASIC copy 

A checksum is a value that is calculated by adding 
together the values of the bytes in the BASIC area of 
RAM. If one or more of these bytes are changed, the 
value of the checksum will change. Therefore, if the 
BASIC system in RAM is changed, the change can be 
detected because its checksum will not be the same as 
the checksum for the original BASIC system. 

When the system is reset, this checksum is checked 
against a recalculated checksum of the BASIC RAM area. 
If these do not agree then a coldboot, which copies 
BASIC into RAM, is initiated. This avoids the problem 
of users or programs poking the BASIC in RAM thus 
causing the system to crash and then performing a 
warmboot which would not restore the correct BASIC 
system. 

Because the BASIC in the 64K mode resides in RAM, it 
is possible to experiment with it. Obviously, great 
care has to be taken with such experimentation as it is 
all to easy to accidentally crash the system. The 
restoration of the original BASIC can be avoided if the 
checksum is recalculated from the 'experimental ' BASIC 
so that it appears that the BASIC system is unchanged. 
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A routine which carries out this recalculation is shown 
below. 



* RECSUM - re-checksum 

* update the 



the BASIC RAM and 
system checksum (CSUM64) 



* Register inputs NONE 
* 



CSUM64 
RECSUM 



NXTADD 



EQU $11B 
PSHS X,D 
LDX #$C000 
LDD #$0 
ADDD ,X++ 
CMPX #$FFOO 
BLO NXTADD 
STD CSUM64 
PULS X,D,PC 



System checksum 

Save registers 

Base of 64K BASIC 

Zero running total 

Add to checksum 

until end of 

BASIC reached 

Update system checksum 

Restore and return 



The original BASIC can be restored by clearing FLAG64 
and then resetting the machine. 

The 64K mode bootstrap is contained in the 'old' 
BASIC ROM at address BF49 onwards. The ROM part of the 
bootstrap copies the RAM part of the bootstrap into the 
cassette buffer since this will not be used during a 
boot, and then jumps into the RAM part to complete the 
boot sequence. Once loaded, the secondary reset vector 
(72:73) is set up to point to the 64K mode bootstrap so 
that subsequent resets will invoke the bootstrap 
automatically . 

Once in 64K mode, there is no easy way to return to 
the 32K mode since a reverse bootstrap has not been 
provided. Whilst expanding into extra RAM (the 64K 
bootstrap) holds no danger, trying to contract back to 
32K of RAM may cause the existing program/variables to 
be overwritten. It may appear that a safe reversion 
technique, which works with programs contained wholly 
in the bottom 32K of RAM is as shown below: 

CLEAR 200,32766 'Default 32K settings 
POKE &H72, &HB4 ' Restore normal 32K 
POKE SH73, &H4F ' secondary reset vector 

In fact, a reset after these statements does not cause 
reversion to 32K mode . To revert requires resetting the 
interrupt vectors and changing various other addresses 
and pointers. 

2. THE RS232 INTERFACE 



An RS232 serial interface (via a 7 pin DIN connector) 
is provided as standard with the Dragon 64 and can be 
used in both the 32K mode and the 64K mode. This 
facility supports the additional commands DLOAD and 
DLOADM which enable BASIC programs, in ASCII format, 
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and machine code programs to be downloaded into the 
Dragon 64 from a host computer . These extra commands 
are very similar in operation to their cassette file 
equivalents CLOAD and CLOADM. However, DLOAD and 

DLOADM are limited to loading files of a particular 
format and cannot be used for more general inter- 
computer communication. 

The download facility of the Dragon 64 is supported 
by three low-level routines, the entry points of which 
are contained in the I/O jump tables. These routines 
are, in actual fact, of more general use for serial I/O 
and a brief description of each is given below. 

* SERIN - Read a byte (8 bits) from the serial port 
* 

* Register inputs NONE 

* Register outputs A - returns byte read 

* Registers destroyed NONE 

* SEROUT - Send a byte (8 bits) to the serial port 

* Register inputs A - byte to be output 

* Registers destroyed NONE 

* SERSET - set up serial port baud rate 
* 

* Register inputs B - baud rate select byte 

* Register outputs CC.C = if select byte OK 

* CC.C = 1 if select byte out of range 

* Registers destroyed B,X,CC 

* 

* The routine supports 7 baud rate select values: 

* B = -> 110 baud 

* B = 1 -> 300 baud 

* B = 2 -> 600 baud 

* B = 3 -> 1200 baud 

* B = 4 -> 2400 baud 

* B = 5 -> 4800 baud 

* B = 6 -> 9600 baud 

* The default baud rate on power-up is 1200 baud 

The entry points in the I/O jump table for these 
routines are: 

802 A SERIN 
80 2D SEROUT 
8030 SERSET 

2.1 Using an RS232 terminal with a Dragon 64 
The above routines can be used in conjunction with the 
character input/output RAM hooks described in section 
9.5.1, to replace the normal Dragon keyboard and screen 
with an RS232 terminal. In this example, we show how 
the character input RAM hook at ISA may be used to 
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redirect input to SERIN and the character output hook 
at 167 to redirect output to the SEROUT routine. 
However, these RAM hooks are also called for cassette 
and printer I/O so you must inspect DEVNUM (6F) to 
avoid redirecting their I/O. 

The following program demonstrates this technique: 



* Redirect console I/O to RS232 terminal 



* Program equates 



HKCHRO 

HKCHRI 

SERIN 

SEROUT 

DEVNUM 



EQU $167 

EQU $16A 

EQU $80 2 A 

EQU $802D 

EQU $6F 

ORG $4E21 



Character output hook 
Character input hook 
Serial input entry point 
Serial output entry point 
Device number location 



* SETIO - set up console I/O redirection 

* Register inputs NONE 

* Registers destroyed A,X,CC 



SETIO 

* 



LEAX INCH,PCR 

STX HKCHRI+1 
LEAX OUTCH,PCR 
STX HKCHRO+1 

LDA #$7E 
STA HKCHRI 
STA HKCHRO 



Set up address of input 
routine 

and redirect console input 

Do the same for 

console output 

Opcode for JMP 

placed in I/O 

RAM hooks 



* Use a call to SERSET here for baud rate setting 

* if not a 1200 baud device 



RTS 



Return 



INCH - input a character from RS232 port 
Register inputs NONE 

Register outputs DEVNUM = -> A contains character 
DEVNUM <> -> A unaffected 



INCH 



TST DEVNUM 
BNE INXIT 
JSR SERIN 



Is this console input 
Yes, read RS232 



At this point, we have input the character from 
the RS232 port and therefore wish to avoid returning 
the code which will input from the normal keyboard. 
Simplest solution is to remove the return address 
from the stack 



INXIT 



LEAS 2,S 
RTS 



Remove latest return 
Return 
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* OUTCH - output a character to RS232 port 

* Register inputs A - contains character 

OUTCH TST DEVNUM ; Is this console output 

BNE OUTXIT 

JSR SEROUT ; Output to RS232 

LEAS 2,S ; Remove return address 

OUTXIT RTS ; Return 

2.2 Using a serial printer with the Dragon 64 

The RS232 port can also be used as the standard printer 
interface instead of the Centronics (parallel) 
interface . Which of these two options is selected is 
determined by location PRNSEL (3FF) . A (default) 
value in this location selects the parallel interface, 
non-0 selects the serial interface. Therefore: 

POKE &H3FF, 1 'Selects serial printer 
POKE &H3FF, 'Selects parallel printer 

In addition to this printer select byte, there are two 
other bytes (3FD: 3FE) which specify an end-of-line 
delay period since some printers (especially serial) 
require this. The time delay is in increments of 10 
milliseconds . For example: 

POKE &H3FE,100 

will provide a delay of 100*10 milliseconds = 1 second. 
The minimum delay (default) is and the maximum delay 
is 655.35 seconds. 

2.3 Configuring the RS232 interface 

The pinout of the RS232 connector is shown in Figure 
A5 . 1 . The device that drives this interface is an 
R6551 Asynchronous Communication Interface Adapter 
(ACIA) which, like the PIA, is a programmable device. 
In its default configuration, this device is programmed 
to produce 1 start bit, 8 data bits and 2 stop bits 
with no parity at a baud rate of 1200 baud. 



PIN 7 -12V- / • • \- PIN 6 TRANSMIT ITX> 

PIN3+12V I a • ) PIN 1 GROUND 




PIN 5 CLEAR TO SEND — \ • • / PIN 4 DATA TERMINAL READY 

(CTS) X • / IDTR) 

PIN 2 RECEIVE DATA 

Fig. AS. 1 RS232 Pin out connections 
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Like all I/O devices in the Dragon 64, the ACIA is 
memory-mapped and occupies the following address space: 

Address Register 

FF04 Transmit data register (on write cycle) 

FF04 Receive data register (on read cycle) 

FF05 Status register 

FF06 Command register 

FF07 Control register 

Because the ACIA is a sophisticated device with many 
options, it is not possible to cover the operation of 
this chip in detail here. In most instances, it is 
easier to configure hardware (printers, terminals, 
etc.) to the default configuration since this is a once 
and for all operation compared to configuration by 
software as this is necessary every time the Dragon is 
switched on. However, we do provide the following 
BASIC statement which can be used to select the baud 
rate of the device. 

POKE &HFF07, ( (PEEK (&HFF07) AND &HFO) OR B) 

The variable B holds a value which specifies the baud 
rate of the device connected to the RS232 interface. 
Possible values are: 



B-value 


Baud rate 


1 


50 


2 


75 


3 


110 


4 


135 


5 


150 


6 


300 


7 


600 


8 


1200 


9 


1800 


10 


2400 


11 


3600 


12 


4800 


13 


7200 


14 


9600 


15 


19200 



3. THE KEYBOARD AUTO-REPEAT FACILITY 

This facility is provided in the 64K mode only and is 
not implemented when the Dragon 64 is operating in 32K 
mode . The reason for this is to maintain compatibility 
with existing software, such as the DREAM assembler, 
which provide their own auto-repeat facilities. 

The auto-repeat makes use of the 50Hz (60Hz) 
interrupt as the timing reference which determines the 
delay before repeating the key and which also controls 
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the rate of repeat. A byte location, REPDLY (11F) in 
RAM contains the inter-repeat delay value. The default 
value of REPDLY is 5 giving an auto-repeat of 10 
characters per second. The same value is also used to 
control the delay before starting the repeat but, in 
this case, its value is multiplied by 8 giving a normal 
delay of 0.8 seconds before auto-repeat starts. By 
altering the value in REPDLY with a POKE statement, you 
may increase or decrease the auto-repeat rate/delay. 

Auto-repeat is incorporated in the 64K mode by 
redirecting the secondary interrupt IRQ vector to an 
additional piece of code (entry point FE18) which is 
dedicated to updating the keyboard delay value. After 
executing this code, a jump is made to the normal 
interrupt service routine. Therefore, the auto-repeat 
facility can be disabled by reinstating the normal 
interrupt service routine entry point (DD3D) into the 
secondary IRQ vector as described in section 8.2.3. 
Conversely, auto-repeat can be incorporated into the 
32K mode by altering the secondary IRQ vector to jump 
to the normally unused keyboard delay update code 
located at BF20 in the 'old' BASIC ROM. 

There are two further 'housekeeping' bytes which are 
also used in the keyboard repeat process. These are 
LSTKEY (11D) which keeps a copy of the last key code 
returned by the keyboard polling routine and CNTDWN 
(HE) which contains the updated delay value which, 
when it reaches zero, triggers the code which resets 
the keyboard rollover table thus causing the current 
key depressing to be recognised as a new depression. A 
mechanism to do this has already been described in 
Chapter 8. 

4. DRAGON 64/32 DIFFERENCES 

The most important differences between these two 
machines have already been covered in the previous 
sections in this appendix. However, there are a few 
other minor differences and these are summarised below. 

4.1 Differences in BASIC 

The only differences between the two machines in terms 
of Extended Color BASIC is that DLOAD and DLOADM are 
implemented in the Dragon 64 and that the USR call bug 
described in Chapter 5 has now been corrected. Recall 
that this bug meant that USR calls 1 to 9 were not 
recognised without a padding character so that USR1 had 
to be written as USR01 , USR2 as USR02, etc. Now, you 
must write these as USR1, USR2, etc. as USR01, USR02, 
etc. are all (correctly) taken to be syntax errors. 

Another slight difference is that the functions 
VARPTR and MEM have been altered so that they return an 
unsigned 16-bit value. Previously, if these functions 
were used with an argument which was greater than 32767 
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they returned a negative result because negative 
integers are represented in two's complement notation 
and have values from 32768 to 65535. Now a positive 
result is always returned. 

4 . 2 RAM usage 

The Dragon 64 in 64K mode provides an extra 16K bytes 
for user/variable storage with 16K bytes used by the 
BASIC and I/O space. The BASIC RAM area can also be 
used for those applications which do not need a 
resident BASIC interpreter such as the OS-9 operating 
system and machine code programs. In addition, some 
unused bytes in the system pages of the Dragon 32 are 
now used by the Dragon 64 . These are locations 11A to 
11F inclusive and 3FD to 3FF inclusive . 

4.3 ROM usage 

There are very few differences between the BASIC ROM 
entry points in the Dragon 32 and the Dragon 64 when in 
32K mode. All the dispatch addresses given in Appendix 
7 remain the same . However , there are a number of ROM 
patches to previously unused areas of ROM in the Dragon 
64 which repair some of the bugs in the Dragon 32 . 
More major differences apply to the area of ROM which 
contains I/O driver code as, obviously, additions have 
been made to support the RS232 interface, the latent 
auto-repeat facility and the 64K mode bootstrap. 

In the 64K mode, the entry points to the system 
routines are now in RAM in the address space COOO to 
FEFF so, obviously, old entry addresses are completely 
incompatible . However, throughout most of this address 
space there is a simple relationship between the old 
ROM entry points and the new ROM entry point since they 
are offset by 4000 (hex) bytes. In other words, the 
direct jump table is located at COOO onwards, the 
indirect jump table at EOOO onwards, etc. This simple 
relationship is maintained until the area of RAM that 
corresponds to the old ROM initialisation sequence 
(B39B/F39B) from which point the relationship no longer 
holds . 

The reason for this is that RESET automatically 
selects map type and therefore enters the 32K mode 
ROM where the initialisation code (RESET service 
routine) resides. This code is not duplicated in the 
BASIC RAM area. 



Appendix 6 

The ASCII character set 



The table below shows the characters in the ASCII 

character set and their associated values. Notice that 

the character values are given in octal (base 8) rather 

than decimal notation. Each octal digit represents 3 

bits from 000 to 111 and the octal representation means 

that the bit pattern of each character may be readily 
deduced. 



000 nul 001 soh 002 stx 003 etx 004 eot 005 enq 

006 ack 001 bel 010 bs Oil ht 012 nl 013 vt 

014 np 015 cr 016 so 017 si 020 die 021 del 

022 dc2 023 dc3 024 dc4 025 nak 026 syn 027 etb 



030 


can 


031 


em 


032 


sub 


033 


esc 


034 


fs 


035 


gs 


036 


rs 


037 


us 


040 


sp 


041 


! 


042 


" 


043 


# 


044 


■</> 


045 


% 


046 


& 


047 


t 


050 


( 


051 


) 


052 


* 


053 


+ 


054 


f 


055 


- 


056 




057 


/ 


060 





061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


7 


070 


8 


071 


9 


072 


j 


073 


9 


074 


< 


075 


= 


076 


> 


077 





100 


@ 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 


110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 





120 


P 


121 


Q 


122 


R 


123 


S 


124 


T 


125 


u 


126 


V 


127 


W 


130 


X 


131 


Y 


132 


Z 


133 


[ 


134 


\ 


135 


] 


136 


A 


137 




140 


\ 


141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


146 


f 


147 


g 


150 


h 


151 


i 


152 


j 


153 


k 


154 


1 


155 


m 


156 


n 


157 


o 


160 


P 


161 


q 


162 


r 


163 


s 


164 


t 


165 


u 


166 


V 


167 


w 


170 


X 


171 


y 


172 


z 


173 


{ 


174 


1 


175 


} 


176 


*s* 


177 


del 
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Appendix 7 
Dragon-specific tables 



This appendix is made up of detailed, Dragon-specific 
information collected together in a tabular form. 
Rather than include such information in the text, we 
have collected a number of tables together in this 
appendix. First, we summarise the functions and 

connections of the individual bits in the Dragon ' s PIA 
registers . 

1. PIA SUMMARY 

(1) PODDRA - Aside data direction register PIAO 

All bits in this register DA0-DA7 are set to 
meaning that the corresponding bits in the PDR 
are inputs. 

(2) POPDRA - Aside peripheral data register PIAO 
Bits PA0-PA6 are connected to keyboard rows to 
6. Bits PA7 is a joystick comparison input and 
bits PAO and PA1 are connected to the right and 
left joystick buttons respectively . PAO and PA1 
are also shared by keyboard rows 1 and 2 thus the 
keyboard must be disabled when joysticks are 
used. 

(3) POCRA - Aside control register PIAO 

The table below shows the functions of the bits 
in this register . 

CRAO CAl control, 0->disable IRQA, l->enable IRQA 

CRA1 CAl control, 0->set IRQA1 on HI to LO, l-> 

set IRQA1 on LO to HI. 
CRA2 0->PODDRA, 1->P0PDRA 

CRA3 CA2 control, 0->CA2 LO, 1->CA2 HI 
CRA4 1 -> CA2 in CRA3 in bit follow mode 
CRA5 as above 
CRA6 IRQA2 flag, not used 

CRA7 IRQA1 flag 

(4) CAl - Horizontal sync interrupt input (63.5 mi- 

croseconds) 

(5) CA2 - LSB of two analog multiplexor select lines 
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(6) PODDRB - B-side data direction register PIAO 

All bits in this registers are set to 1 thus con- 
figuring the corresponding bits in POPDRB as out- 
puts. 

(7) POPDRB - B-side peripheral data register PIAO 
This register is shared by the keyboard input and 
printer data lines. Bits PB0-PB7 are either con- 
nected to keyboard matrix columns to 7 or are 
printer data bits to 7. 

(8) POCRB - B-side control register PIAO 

The table below summarises the functions of the 
bits in this register. 

CRBO CB1 control -> disable IRQB, 

1 -> enable IRQB 
CRB1 CB1 control -> set IRQB1 on Hi to LO, 

1 set IRQB1 on LO to HI 
CRB2 -> PODDRB, 1 -> POPDRB 
CRB3 CB2 control, -> CB2 LO, 1 -> CB2 HI 
CRB4 =1 CB2 in CRB3 bit follow mode 
CRB5 =1 CB2 in CRB3 bit follow mode 
CRB6 IRQB2 flag, not used 
CRB7 IRQB1 flag 

(9) CB1 - field sync interrupt (20ms, 50Hz) 

(10) CB2 - MSB of analog multiplexor select lines 

(11) P1DDRA - Aside data direction register PIA1 

Bit in this register is thus configuring bit 
in the peripheral data register as an input . 
All other bits are 1, configuring associated 
peripheral data bits as outputs. 

(12) P1PDRA - Aside peripheral data register PIA1 
Bits 2 to 7 in this register correspond to bits 
0-5 of a 6-bit DAC input value. Bit is a 
cassette data bit input and bit 1 is the printer 
strobe output . 

(13) P1CRA - Aside control register PIA1 

The functions of the bits in this register are 
summarised in the table below. 

CRAO CAl control, 0->disable IRQA, 

1 -> enable IRQA 
CRA1 CAl control, 0->set IRQA1 on HI to LO, 

1 -> set IRQA1 on LO to HI 
CRA2 -> P1DDRA, 1->P1DDRA 
CRA3 CA2 control, 0->CA2 LO, 1->CA2 HI 
CRA4 =1 -> CA2 in CRA3 bit follow mode 
CRA5 =1 -> CA2 in CRA3 bit follow mode 
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CRA6 IRQA2 flag, not used 
CRA7 IRQA1 flag 

(14) CA1 - printer acknowledge interrupt input, not 
used 

(15) CA2 - cassette motor control, -> off, 1 -> on 

(16) P1DDRB - B-side data direction register PIA1 
Bits to 2 in this register are 0, configuring 
associated bits as inputs. Bits 3-1 are 1, con- 
figuring associated bits as outputs. 

(17) P1PDRB - B-side peripheral data register PIA1 
Bits 3 to 7 in this register are VDG control 
lines. Bit is a printer busy input, bit 1 is 
used for single bit sound and bit 2 is a RAM type 
detect bit. If it is 0, available RAM is 32K or 
64K type. If it is 1, available RAM is 16K type. 
In the Dragon 64, bit 2 is programmed as an out- 
put to select between the 32K mode BASIC ROM (bit 
2 = 1, default) and the 64K mode BASIC ROM (bit 2 
= 0) . 

(18) P1CRB - B-side peripheral control register PIA1 
The table below summarises the functions of the 
bits in this register. 

CRBO As POCRB 

CRB1 As POCRB 

CRB2 0->PlDDRB, 1->P1PDRB 

CRB3 CB2 control, 0->CB2 LO, 1->CB2 HI 

CRB4 =1 CB2 in CRB3 bit follow mode 

CRB5 =1 CB2 in CRB3 bit follow mode 

CRB6 IRQB2 flag, not used 

CRB7 IRQB1 flag 

(19) CB1 - ROM cartridge interrupt detect 

(20) CB2 - sound source enable 



2. RESERVED WORD TABLE 

The following tables list the reserved words of 
Extended Color BASIC, their internal tokens and the 
addresses of associated action routines. 



Reserved word 


Token 


Dispatch a ddre s s 


FOR 


80 




8448 


GO (TO/SUB) 


81 




85B9 


REM 


82 




8616 




83 




8616 


ELSE 


84 




8616 
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IF 


85 


8641 


DATA 


86 


8613 


PRINT 


87 


903D 


ON (GOTO/SUB) 


88 


8615 


INPUT 


89 


812B 


END 


8A 


8532 


NEXT 


8B 


8829 


DIM 


8C 


8A8B 


READ 


8D 


8111 


LET 


8E 


86BC 


RUN 


8F 


85A5 


RESTORE 


90 


8514 


RETURN 


91 


85F3 


STOP 


92 


8539 


POKE 


93 


8E9D 


CONT 


94 


8560 


LIST 


95 


8EAA 


CLEAR 


96 


8511 


NEW 


91 


8415 


DEF 


98 


9C81 


CLOAD 


99 


B6D5 


CSAVE 


9A 


B683 


OPEN 


9B 


B829 


CLOSE 


9C 


B64D 


LLIST 


9D 


8EA4 


SET 


9E 


B9D3 


RESET 


9F 


BA04 


CLS 


AO 


BA60 


MOTOR 


Al 


B982 


SOUND 


A2 


BA9B 


AUDIO 


A3 


BADF 


EXEC 


A4 


Bill 


SKIPF 


A5 


B81F 


DELETE 


A6 


9D61 


EDIT 


Al 


9965 


TRON 


A8 


9AD9 


TROFF 


A9 


9ADA 


LINE 


AA 


A149 


PCLS 


AB 


A8C0 


PSET 


AC 


A6EF 


PRESET 


AD 


A6F3 


SCREEN 


AE 


A9FE 


PCLEAR 


AF 


AA19 


COLOR 


BO 


A8D4 


CIRCLE 


Bl 


B238 


PAINT 


B2 


AC81 


GET 


B3 


AAFO 


PUT 


B4 


AAF3 


DRAW 


B5 


B051 


PCOPY 


B6 


AABE 


PMODE 


Bl 


A9AF 


PLAY 


B8 


ADBD 


DLOAD 


B9 


A049 


RENUM 


BA 


9DFA 
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TAB( 


BB 


N/A 


TO 


BC 


N/A 


SUB 


BD 


N/A 


FN 


BE 


N/A 


THEN 


BF 


N/A 


NOT 


CO 


N/A 


STEP 


CI 


N/A 


OFF 


C2 


N/A 


+ 


C3 


N/A 


- 


C4 


N/A 


* 


C5 


N/A 


/ 


C6 


N/A 


© 


CI 


N/A 


AND 


C8 


N/A 


OR 


C9 


N/A 


> 


CA 


N/A 


= 


CB 


N/A 


<■ 


CC 


N/A 


JSING 


CD 


N/A 



The tokens which have a dispatch address 'N/A' are 
normally handled by other action routines and are not 
the first word of a BASIC statement . For example, the 
MOTOR action routine looks for OFF or ON, the FOR 
action routine looks for STEP and arithmetic and 
logical operators are handled by an expression 
evaluation routine. 

This evaluation routine uses its own dispatch table 
to initiate actions for each operator and intrinsic 
function . 



Operator /Function 


Token 


Dispatch address 


+ 


C3 


91 OE 


- 


C4 


9105 


* 


C5 


9275 


/ 


C6 


933C 


© 


CI 


96A0 


AND 


C8 


8A12 


OR 


C9 


8 All 


SGN 


FF80 


9425 


INT 


FF81 


9499 


ABS 


FF82 


943E 


POS 


FF83 


9ADE 


RND 


FF84 


9772 


SQR 


FF85 


9697 


LOG 


FF86 


923C 


EXP 


FF81 


9713 


SIN 


FF88 


97D1 


COS 


FF89 


97 CB 


TAN 


FF8A 


9816 


ATN 


FF8B 


9877 


PEEK 


FF8C 


8E96 


LEN 


FF8D 


8DC7 


STR$ 


FF8E 


8C40 
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VAL 


FF8F 


8E5C 


ASC 


FF90 


8DE6 


CHR$ 


FF91 


8DD2 


EOF 


FF92 


B801 


JOYSTK 


FF93 


BBOD 


FIX 


FF94 


9956 


HEX$ 


FF95 


AOOE 


LEFT$ 


FF96 


8DF1 


RIGHT$ 


FF91 


8E0E 


MID$ 


FF98 


8E15 


POINT 


FF99 


BA45 


INKEY$ 


FF9A 


B797 


MEM 


FF9B 


8C31 


VARPTR 


FF9C 


9AF4 


INSTR 


FF9D 


9BB4 


TIMER 


FF9E 


9D59 


PPOINT 


FF9F 


A6C7 


STRING$ 


FFAO 


9B84 


USR 


FFA1 


9D1D 



3. I/O JUMP TABLES 

As we have Indicated in the text, system I/O routines 
may be accessed via a direct jump table starting at 
address 8000 and an indirect jump table at address 
AOOO. The routines accessible through the direct jump 
are listed below: 

Address Routine 

8000 Hardware initialisation 

8003 Software initialisation 

8006 Keyboard input 

8009 Cursor blinking 

800C Screen output 

800F Printer output 

8012 Joystick input 

8015 Cassette on 

8018 Cassette off 

801B Write leader to cassette 

801E Byte output to cassette 

8021 Cassette on for reading 

8024 Byte input from cassette 

8021 Bit input from cassette 

802A Read a byte from another computer 

802D Send a byte to another computer 

8030 Select baud rate of communication line 

The routines accessible via the indirect jump table 
are: 

Address Routine 

AOOO Keyboard input 

A002 Character output routine 
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A004 Cassette on for reading 

A006 Block Input from tape 

A008 Block output to tape 

AOOA Joystick Input 

AOOC Write leader to cassette 

Almost all of these routines have been described In the 
text . Those which we have not described are the three 
routines used when the Dragon Is set up to communicate 
with another machine and support the DLOAD/DLOADM 
features of Extended Color BASIC. These features are 
not supported In the Dragon 32 but are available In the 
Dragon 64 . 

The character output routine which may be accessed 
through Indirect jump address A002 Is a general-purpose 
routine which can output a character to either the 
screen, the printer, or the cassette. The character to 
be output should be In register A and location 6F 
(DEVNUM) should be set up with a device number. To 
output to the screen, DEVNUM should be 0, to the 
cassette, DEVNUM should be -1 and If output to the 
printer Is required, DEVNUM should be -2 . 



Appendix 8 

The disk operating system 



The Internal workings of the Dragon 's disk operating 
system (DOS) are too complicated for us to describe in 
detail here. Therefore, we restrict ourselves to a 
brief description of the differences between the normal 
Dragon 32 system requirements and the system 
requirements of the DOS. 

1. DOS WORK SPACE 

The Dragon 's DOS reallocates the memory area normally 
occupied by the first graphics page, 600 to BFF, for 
its own use. This means that the graphics pages and 
BASIC program/variable areas are offset by 1536 
(decimal) bytes from their normal position as shown in 
Figure 1.3. Fortunately, Extended Color BASIC has been 
designed with this in mind so it has no effect on 
existing BASIC programs other than reducing the free 
space available to them by 1.5K. 

This 1.5K DOS work space is used for variables, 
buffers, etc. and a breakdown of its organisation is 
provided in the table below. 

Address Usage 

600-604 Temporary storage 

605-609 Controller variables 

60A Default drive number 

60B-.60C Address of FWRITE buffer 

60D-.60E AUTO, current line number 

60F-.610 AUTO, current increment 

611 RUN/LOAD flag 

612 FREAD/FLREAD flag 

613 AUTO flag, 00=OFF, FF=ON 

614 ERROR falg, 00=OFF, FF=ON 
615:616 ERROR destination line number 
617:618 Line number in ERROR 

619 ERROR type 

61A-.61B Address of start of statement in ERROR 

61C-621 Drive 1 details 

622-627 Drive 2 details 

628-62D Drive 3 details 

62E-633 Drive 4 details 

634-63A Disk buffer 1 details 

63B-641 Disk buffer 2 details 
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642 — 648 Disk buffer 3 details 

649 — 64F Disk buffer 4 details 

650 — 682 Current drive information 

683—696 USR vector table (relocated from 134 — 247; 

697 — 6AA Drive descriptor table 

6Kb — 6BC Directory sector status 

6BD — 1F2 File control blocks (10) 

Each FCB is 32 bytes long 
1F3 — IFF Temporary variables 
800— EFF Disk buffers (4) 

Each disk buffer is 256 bytes long 

In addition to the workspace area 600 to BFF, the DOS 
makes use of some of the base page locations which are 
unused by Extended Color BASIC. These are: 

Address Use 

EA Disk command byte 

EB Drive unit number 

EC Track number 

ED Sector number 

EE:EF Address of disk buffer area 

FO Disk status byte 

Fl Current file control block number 

F2 Number of bytes in disk buffer area 

F3 Number of bytes to transfer to/from buffer 

F4 Record length flag, O0=don'tcare, FF=do care 

F5 Read/write flag, 00=read, 01=write, FF=verify 

F6 IRQ time out flag, 00=check for time out 
Non-O0=skip time out check 

2. DOS LINKS WITH BASIC 

The Dragon 's DOS extends the facilities of Extended 
Color BASIC using the same techniques as described in 
section 9.5. Most of these extended facilities are 
directly associated with floppy disk file management 
such as SAVE, LOAD, BACKUP, etc. However, there are a 
number of other commands which extend the BASIC itself 
such as AUTO, ERROR, GOTO, WAIT, etc. These disk and 
BASIC commands are described in detail in the booklet 
supplied wth the DOS and we do not describe them 
further here. Rather, we concentrate on the details of 
how these new commands are linked to the existing BASIC 
system. 

As we described in section 9.1.1, part of the 
initial power-on/reset sequence is to look for a disk 
controller cartridge and, if it is present, jump to its 
initialisation routine (entry point CO 02) . The DOS 
initialisation routine sets up a second command 
interpretation vector table (stub) from 12A-133 
inclusive with each entry point set up as shown in the 
table below. 
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Address 


Contents 


12A 


la 


12B-.12C 


DED4 


12D-.12E 


C64C 


12F 


01 


130:131 


DEBB 


132:133 


C667 



Use 
Number of DOS reserved words 
Address of DOS word list 
Address of DOS word dispatch routine 
Number of DOS functions 
Address of functions list 
Address of functions dispatch routine 



The third stub acts as the terminator and occupies RAM 
at 134-147. This means that the USR vector table which 
normally occupies that address space has to be 
relocated into the DOS workspace (683-696) . 

The following tables list the reserved 

words/functions of the DOS, their internal tokens and 
the addresses of associated action routines. 



Reserved word 


Token 


Dispatch address 


AUTO 


CE 


DADC 


BACKUP 


CF 


C520 


BEEP 


DO 


DB90 


BOOT 


Dl 


DC03 


CHAIN 


D2 


D503 


COPY 


D3 


D332 


CREATE 


D4 


D725 


DIR 


D5 


DA35 


DRIVE 


D6 


DC3C 


DSKINIT 


Dl 


C397 


FREAD 


D8 


D7FB 


FWRITE 


D9 


D8A5 


ERROR 


DA 


DC 4 9 


KILL 


DB 


D774 


LOAD 


DC 


D4A7 


MERGE 


DD 


D3E5 


PROTECT 


DE 


D781 


WAIT 


DF 


DBC1 


RENAME 


EO 


D7A5 


SAVE 


El 


D53F 


SREAD 


E2 


DC79 


SWRITE 


E3 


DCC8 


VERIFY 


E4 


DD36 


FROM 


E5 


89B4 


FLREAD 


E6 


D7C7 


SWAP 


E7 


DBD5 


Function 


Token 


Dispatch address 


LOF 


A2 


DD88 


FREE 


A3 


DDA3 


ERL 


A4 


DDBB 


ERR 


A5 


DDC1 


HIMEM 


A6 


DDC7 


LOC 


A7 


DD7A 


FRE$ 


A8 


DDCB 



In addition to these new reserved words and functions, 



353 

some of the existing BASIC commands such as CLOSE and 
RUN now relate to the DOS. Such commands are linked 
into the DOS via the RAM hooks described in section 
9.5.1. There are several new entries in the RAM hooks 
as summarised in the table below. 



Ram hook 


Jump address 


15E-160 


D902 


167-169 


D8FA 


176-178 


D917 


1 7C-1 7E 


D960 


182-184 


D720 


18 8-1 8 A 


DD4D 


191-193 


C69E 


194-196 


D490 



Index 



208, 



46 



A register, 22, 23 
A-D conversion, 220 
accumulator offset indexed 

addressing, 34 
action routines, 229 
add instructions, 47 
alphanumeric display modes, 

159 
analogue multiplexor, 

220 
and instructions , 52 
animation, 180 
animation delay, 182 
arithmetic expression 

evaluation, 86 
arithmetic instructions , 
arithmetic shift 

instructions, 54 
arrays, 107 
ASCII, 7 

assembler directives, 
assembler facilities, 
assembler memory map, 
assembler program counter, 

77 
assembly code, 

hand-translation, 39, 75 
assembly language program 

development, 67 
assembly language 

programming 

advantages, 66 
disadvantages , 66 
assignment statements, 84 
auto increment /decrement, 

11, 24, 73 
auto increment /decrement 

indexed addressing, 33 



B register, 22, 23 



75 
69 
76 



BASIC 

adding new commands , 

239 
array descriptors, 230 
array storage, 229 
dump program, 226 
graphics display, 158 
I/O routines, 146 
information 

representation, 230 
largest number, 232 
number representation, 

230 
program storage, 226 
reserved words, 228 
smallest number, 232 
system variables, 

244-248 
text display, 152 
variable storage, 229 
variables, 234 

binary arithmetic, 4 

binary numbers, 3 

binary search, 220 

bit test instructions, 55 

BITIN, 21 6 

BLKIN, 21 6 

BLKOUT, 21 6 

branch instructions, 57 

BREAK key, disabling of, 
244 

bus, 1, 37 

connections, 222 

byte test instructions , 56 

byte, 4 



cartridge expansion port, 

221 
CASOFF, 21 6 
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CAS ON, 215 

cassette control, 213 

cassette routines, entry 

points, 217 
CBIN, 21 6 
CBOUT, 21 6 

Centronics interface, 205 
character input routine, 

102 
character output routine, 

103 
character representation, 7, 

159 
character strings, 132 

fundamental operations, 

133 
manipulation routines, 

137-142 
representation 

techniques, 134 
storage area, 133 
checkerboard pattern, 162 
CHKHP, 137 
CHRGET, 240 
clear instructions, 49 
clear screen, 173 
CLOADM statement, 149 
clock, 1 
CLS, 173 
CMPSTR, 140 
cold-start initialisation, 

225 
colour conversion program, 

179 
colour graphics 

1 mode, 163 

2 mode, 163 

3 mode, 164 
6 mode, 164 
display modes, 161 

colour set, 154, 162 

selection, 172 
command interpretation 
vector 

defining new, 241 
(stub), 239 
comments field, 74 
compare instructions , 56 
complement arithmetic, 5, 6 
complement instructions , 53 
compound conditional 

expressions, 94 
computer architecture, 2 



condition code (CC) 

register, 11, 26, 40, 
124 

conditional constructs, 89 

constant offset indexed 
addressing, 34 

C0PY1B, 181 

C0PY2B, 177 

CPSTR, 137 

CSRDON, 21 6 

CSS, 1 72 

cursor 

addressing, 160 
blinking, 160 



D register, 23 

DAC, 213, 220 

DACOUT, 21 

data highway, 1 

data movement instructions, 
41 

decimal adjust instruction, 
50 

decimal arithmetic, 8, 9 

decimal system, 3 

DELAY, 182 

digital-to-analogue 
conversion, 210 

direct addressing, 28, 72, 
78, 147 

dispatch table, 229 

DP register, 25 

Dragon block diagram, 15 

Dragon logo, 175 

animation, 182 
colour data table, 180 
data table, 176 
flame data table, 181 
grid pattern, 176 
repetition, 178 

Dragon memory map, 1 7 

Dragon memory organisation, 
16-19 

DREAM assembler, 70 

dynamic RAM, 16 



EQU directive, 77 

exchange instructions , 43 

EXEC statement, 148 

EXEC vector, 148 

extended addressing, 27, 72 
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FCB/FCC directive, 78 

FDB directive, 79 

FIB, 131 

Fibonacci numbers, 130 

FILLER, 1 78 

FIRQ, 190 

floating point accumulator 

(FAC) , 232 
for loops, 97 
FREESP, 135, 136, 139 
frequency shift keying, 213 
FULL6R, 172 



garbage collection, 135 

general purpose register, 
10 

GETSP, 135, 136, 138 

GIVABF, 232, 234 

GMODE, 1 71 

goto statements, 101 

graphics 

display hardware, 152 
hardware setup, 170 
modes, 153 
page selection, 173 
segment size, 156 
symbol design, 175 
symbols, 174 
test rig, 158 
utilities, 169 



heap, 135 

hexadecimal notation, 7, 8 
hexadecimal system, 3 
high-level language 
programming , 65 



I/O hardware diagram, 187 
I/O programming techniques, 

193 
Iliffe vectors, 109 
immediate addressing, 27, 

72, 144 
index registers, 23-24 
index registers for array 

accessing, 108 
indexed addressing, 31, 72 
indirect addressing, 29, 30, 

73 
input and output, 101 



instruction format, 26, 27, 

74 
INTCNV, 232, 234 
integer representation, 5 
interrupt handling 

instructions, 62, 191 
interrupt mask, 188 
interrupt priority, 189, 

191 
interrupt processing, M6809, 

general, 189 
interrupt service routine, 

188, 197 
interrupt vector, 188, 190, 

193 
inter rupt -driven I/O 

transfer, 195 
interrupts, 188 

adding new service 

routines, 196 
Dragon-specific, 192 
software, 191 
INV control bit, 161 
IRQ, 189, 197 
IRQSET, 1 98 

JOYIN, 21 9 
joystick 

buttons, 219 

control, 218 

I/O, 194 

selection, 221 

values, 219 
JOYSTK, 218 
jump instructions, 63 
jump tables, 80, 145 

direct, 146 

indirect, 146 

initialisation of, 147 



keyboard 

auto-repeat, 204 
conrol, 201 
matrix, 201 
scanning, 202, 220, 

244 
state bytes, 203 



label field, 71 
load effective address 
instructions , 44 



357 



load instructions , 42 
local variables, 129 
logic instructions, 51 
logical shift instructions, 

54 
LOGOTL, 177 
loop constructs, 96 
low-level language 

programming, 65 
LPOUT, 206 



M6809 programming model, 21 
M6809 registers, 21 
machine code loader, 82 
machine code monitor, 

111-120 
machine instructions, 11, 

12, 38 
MAXMIN, 129 
memory addresses, notation, 

41 
memory-mapped input / output , 

36 
mnemonic field, 72 
MOVFM, 232, 235 
multi-armed conditionals , 

93 
multiplication and division 

88 
multiply instruction, 49 



negate instructions , 50 

NEWDSP, 240 

NEWSET, 241 

NMI, 190 

no-operation instruction, 

63 
number conversion, 232 
numerals, 3 



operand field, 72 
optimisation, 68, 91, 93, 

98, 100, 106 
or instructions, 52 
ORG directive, 80 



PAGEX, 1 73 
parameter passing 

in registers, 123 



using parameter area, 
125 

using stack, 125 
PAT GEN, 1 62 

PC-relative addressing, 143 
PCLS, 158 
PEEK and POKE, 88 
PIA, 155, 193, 198 

control lines, 199 

control register, 199 

data direction 
register, 199 

data register, 199 

equate table, 201 
PIAs, Dragon-specific, 200 
PMODE, 157 

polled I/O transfer, 194 
position-independent code, 

35, 78, 142 
postbyte, 27, 31, 32 
power-up/reset actions, 224 
print routine, 243 
printer control, 205 
printer control lines, 205 
printer routine parameters, 

206 
problem solving, 121 
processor architecture, 9 
program counter, 12 
PULL, 14 

pull instructions, 46 
PUSH, 14 

push instructions, 45 
PUT directive, 81 



R32C0L, 1 74 

RAM hooks, 242-244 

read-only memory, 16 

real number representation, 

231 
recursion, 125, 130, 131 
register addressing, 29, 72 
register, 9, 10 
relative addressing, 35 
relative branch 

instructions , 143 
repeat loops, 100 
RESET, 190 
resolution graphics 

1 mode, 165 

2 mode, 165 

3 mode, 166 



358 



6 mode, 166 
modes, 164 
return instruction, 64 
returning results on the 

stack, 128 
RMB directive, 80 
rotate instructions , 54 



SAM chip, 156 

SAM control register, 156 

SAMMOD, 1 10 

SAMSET, 1 12 

SCREEN, 151 

SEMI 8, 112 

Semigraphics 

4 mode, 161 

6 mode, 161 

8 mode, 168 

12 mode, 166 

24 mode, 166 

character organisation , 

161 
display modes, 166 
shift instructions , 53 
sign bit, 5 

sign extend instruction, 50 
signed conditional branch 

instructions , 59 
simple conditional branch 

instructions, 59 
single-armed conditionals, 

90 
SNDSEL, 209 
sound control, 201 
sound output generation, 

211 
sound source selection, 209 
sound source, single bit, 

212 
sound sources, 208 
special purpose register, 

10 
SQUARE, 123, 126, 128 
stack, 12, 13 
stack frame, 126, 121 
stack pointer, 13 
stack pointer registers, 24, 

25 
STINIT, 136 
store instructions, 43 
STRCAT, 140 
string descriptor, 233 



string representation, 233 
subroutines, 105, 121 

assembly language, 122 
call sequence, 129 
disadvantages of BASIC, 

121 
entry/exit sequence, 

129 
parameter passing, 106 
register conventions, 
106 
SUBSTR, 141 

subtract instructions, 48 
synchronous address 
multiplexor, 14 



tape file format, 214 
tape leader 

format, 214 
length, 215 
tape verification, 215 
test instructions , 55 
transfer instructions , 43 
two 's complement, 6 
two-armed conditionals , 92 
two-dimensional arrays, 108, 

110 
TXPCH, 201 



unconditional branch 

instructions, 58 
unconditional I/O transfer, 

194 
unsigned conditional branch 

instructions , 60 
USR calls, 149, 235 
bugs, 149 
numeric parameters, 

235 
string parameters, 236 
string results, 231 
USRASC, 236 
USRINC, 231 



VALTYP, 234 
VARPTR, 234 
VDG, 153, 159 

control lines, 154, 
155 
VDG/ SAM addresses, 169 
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VDGMOD, 170 x register, 23 

video RAM, 155 

Y register, 23 
warm-start initialisation, 

225 
while loops, 99 zero offset indexed 

word, 4 addressing, 34 



Calling all DRAGON owners 

If you have ever wanted to get more from your machine, but 
have been held back by a lack of documentation on its internal 
hardware and software, INSIDE THE DRAGON is the answer 
to your problem. 

The authors have assembled in this book a wealth of 

information not previously available in one place. No one who 
wants to do more with their Dragon than merely play games 
can afford to be without it. 

Among the topics covered are: 

* The architecture of the M6809 - the chip at the heart of the 
machine 

* programming the M6809 
" input/output hardware 

* graphics hardware 

* the Dragon 64 

* the disc operating system 

Also included in the book are the manufacturer's data sheets 
for the M6809 processor, the SN74LS783 multiplexer, the 
MC6847 video display generator, and the MC6821 interface 
adaptor; invaluable aids to the serious user. 

The Dragon is similar in many areas to tne'S'ajndy Color 
Computer so owners of that machine will find plenty in the 
~->k to interest them also. 
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